Nynch MCP Server

Nynch MCP Server

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

46 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 não tem estado (sem sessão para gerenciar) e negocia a versão do protocolo com seu cliente — ele suporta 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á para Configurações → Integrações → Claude & AI Assistants e crie uma chave de API.

Escopos:

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

2. Configure Seu Cliente

Claude Desktop

Adicione em claude_desktop_config.json:

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

Cursor

Adicione em .cursor/mcp.json:

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

Python (MCP SDK)

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 pipeline, criar tarefas ou analisar relacionamentos.

Catálogo de Ferramentas

Leitura de CRM (10 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: partes interessadas, aprendizados, ações de coaching
search_deals_by_inactivity	Encontrar negócios parados sem atividade recente
get_pipeline_summary	Saúde do pipeline: distribuição por etapa, negócios em risco, fechamentos futuros
get_next_best_actions	Recomendações com IA sobre o que fazer em seguida
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 de contato (ligação, e-mail, reunião, nota)
update_deal_stage	Mover um negócio para uma nova etapa do pipeline
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 de um contato existente
add_contact_to_bucket	Adicionar um contato a um bucket
create_deal	Criar um novo negócio no pipeline
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 Say/Do e datas de vencimento
get_buying_committee	Mapa de partes interessadas: papéis, influência, sentimento
get_contact_signals	Mudanças de cargo, mudanças de empresa, sinais de intenção de compra
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 com 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 partes interessadas, 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 que o agente está ativo
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 metadados em primeiro lugar. 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, partes interessadas, ações de coaching
nynch://pipeline/summary	Visão geral da saúde do pipeline

Orquestração de Agentes

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

• Registre-se 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 a 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) é lançado sob a Licença MIT. O próprio Nynch MCP Server é um serviço hospedado — nenhuma instalação local é necessária.