Nynch MCP Server

Servidor Nynch MCP

Um servidor Model Context Protocol hospedado que dá aos agentes de IA acesso total ao Nynch — uma plataforma de crescimento orientada a relacionamentos para consultores e empresas de serviços profissionais.

47 ferramentas em 5 categorias: leitura de CRM, escrita de CRM, inteligência de relacionamento, consulta de contexto e orquestração multiagente.

Endpoint

https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server

Transporte: JSON-RPC 2.0 sobre HTTP Streamable. O servidor é stateless (sem sessão para gerenciar) e negocia a versão do protocolo com seu cliente — ele fala 2025-11-25, 2025-06-18 e 2025-03-26.

Início Rápido

1. Obtenha uma Chave de API

Cadastre-se em nynch.com e depois vá em Configurações → Integrações → Claude & Assistentes de IA e crie uma chave de API.

Escopos:

• read — Pesquisar, navegar e recuperar dados
• read-write — Ler + criar, atualizar, excluir registros
• admin — Acesso total, incluindo orquestração de agentes

2. Configure Seu Cliente

Claude Desktop

Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "nynch": {
      "url": "https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

Adicione ao .cursor/mcp.json:

{
  "mcpServers": {
    "nynch": {
      "url": "https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Python (SDK MCP)

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client(
    "https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        result = await session.call_tool("search_contacts", {"query": "Acme Corp"})
        print(result)

3. Comece a Usar as Ferramentas

Seu cliente de IA descobre as ferramentas disponíveis automaticamente. Peça para pesquisar contatos, verificar seu funil, criar tarefas ou analisar relacionamentos.

Catálogo de Ferramentas

Leitura de CRM (11 ferramentas)

Ferramenta	Descrição
search_contacts	Pesquisar contatos por nome, empresa ou tags
get_contact_context	Contexto completo do contato: perfil, interações, atividades, notas, rede
search_deals	Pesquisar negócios por título, etapa ou empresa
get_deal_context	Contexto completo do negócio: stakeholders, aprendizados, ações de coaching
search_deals_by_inactivity	Encontrar negócios parados sem atividade recente
get_pipeline_summary	Saúde do funil: distribuição por etapa, negócios em risco, fechamentos próximos
get_next_best_actions	Recomendações com IA para os próximos passos
get_who_list	Pessoas para contatar agora, incluindo visitantes identificados do site. Nunca mencione uma página específica no contato
list_buckets	Listar todos os buckets (listas/segmentos)
get_bucket_contacts	Obter contatos em um bucket específico
get_bucket_game_queue	Obter contatos aguardando classificação em buckets

Escrita de CRM (12 ferramentas)

Ferramenta	Descrição
log_interaction	Registrar uma interação com contato (ligação, e-mail, reunião, nota)
update_deal_stage	Mover um negócio para uma nova etapa do funil
create_task	Criar uma tarefa vinculada a um contato ou negócio
create_note	Adicionar uma nota a um contato (suporta markdown)
create_contact	Criar um novo contato (vincula automaticamente à empresa por domínio)
update_contact	Atualizar campos em um contato existente
add_contact_to_bucket	Adicionar um contato a um bucket
create_deal	Criar um novo negócio no funil
create_company	Criar uma nova empresa
delete_contact	Exclusão suave de um contato (recuperável)
bulk_delete_contacts	Exclusão suave de contatos por tag ou lista de IDs
update_commitment	Marcar um compromisso como concluído ou atualizar detalhes

Inteligência de Relacionamento (11 ferramentas)

Ferramenta	Descrição
get_authority_score	Pontuação de autoridade em 6 dimensões
get_commitments	Compromissos com acompanhamento de Dito/Feito e datas de vencimento
get_buying_committee	Mapa de stakeholders: papéis, influência, sentimento
get_contact_signals	Mudanças de emprego, mudanças de empresa, intenção de compra, visitas identificadas ao site (sem caminhos de página)
get_interaction_history	Linha do tempo completa de interações com direção e sentimento
get_relationship_score	Pontuação de força do relacionamento em 5 fatores
export_context_briefing	Briefing de contexto pronto para IA para qualquer contato ou negócio
get_relationship_trends	O engajamento está crescendo, estável ou diminuindo?
get_at_risk_relationships	Contatos com pontuações em queda ou sem contato recente
get_deal_intelligence	Saúde do negócio: velocidade, cobertura de stakeholders, fatores de risco
get_weekly_briefing	Resumo semanal: interações, mudanças, recomendações

Orquestração de Agentes (8 ferramentas)

Ferramenta	Descrição
register_agent	Registrar um agente externo com capacidades e arquétipo
list_agents	Listar agentes registrados com status
agent_heartbeat	Confirmar atividade do agente
write_context	Escrever no armazenamento de contexto compartilhado de agentes
read_context	Ler do armazenamento de contexto (suporta curingas de prefixo)
create_handoff	Solicitar que outro agente execute uma tarefa
get_handoffs	Obter transferências pendentes para seu agente
complete_handoff	Marcar uma transferência como concluída ou falha

Consulta de Contexto (5 ferramentas)

Descubra e leia fatias limitadas do contexto do Nynch e de aplicativos conectados, com foco em metadados. Somente leitura — nunca aceita SQL bruto.

Ferramenta	Descrição
list_context_sources	Listar fontes de contexto seguras somente leitura disponíveis para você
search_context_sources	Pesquisar fontes de contexto por palavra-chave em linguagem natural (somente metadados)
describe_context_source	Descrever uma fonte: finalidade, colunas, filtros, limites, disponibilidade
list_context_columns	Listar colunas selecionáveis e filtros permitidos para uma fonte
query_context	Ler uma fatia limitada de uma fonte por meio de um objeto de consulta restrito

Recursos MCP

Modelo de URI	Descrição
nynch://contacts/{id}	Contexto completo do contato: perfil, pontuação, interações, rede
nynch://deals/{id}	Contexto do negócio: detalhes, stakeholders, ações de coaching
nynch://pipeline/summary	Visão geral da saúde do funil

Orquestração de Agentes

O Nynch suporta fluxos de trabalho multiagente em que agentes de IA se registram, compartilham contexto e transferem tarefas:

• Registre com nome, capacidades e arquétipo (produtor, consumidor, coordenador, crítico)
• Compartilhe estado por meio de um armazenamento de contexto chave-valor com namespaces e TTLs
• Roteie tarefas por nome do agente ou correspondência de capacidades
• Acompanhe atividade com heartbeats

Limites de Taxa

• 1.000 solicitações por hora por chave de API

Documentação

Documentação completa para desenvolvedores: nynch.com/developers

Sobre o Nynch

Nynch é uma plataforma de crescimento orientada a relacionamentos que ajuda consultores e empresas de serviços profissionais a transformar relacionamentos em receita. Ela combina CRM, inteligência de relacionamento e coaching com IA em uma única plataforma.

Licença

Este repositório (documentação e configuração) é distribuído sob a Licença MIT. O próprio Servidor Nynch MCP é um serviço hospedado — nenhuma instalação local é necessária.