Nynch MCP Server
Servidor MCP de 42 herramientas para CRM, inteligencia de relaciones y orquestación multiagente. Busca contactos, gestiona acuerdos, analiza relaciones y coordina agentes de IA.
Documentación
Servidor Nynch MCP
Un servidor de Protocolo de Contexto de Modelo alojado que brinda a los agentes de IA acceso completo a Nynch, una plataforma de crecimiento impulsada por relaciones para consultores y firmas de servicios profesionales.
47 herramientas en 5 categorías: lectura de CRM, escritura de CRM, inteligencia de relaciones, consulta de contexto y orquestación multiagente.
Endpoint
https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server
Transporte: JSON-RPC 2.0 sobre HTTP Streamable. El servidor no tiene estado (no hay sesión que gestionar) y negocia la versión del protocolo con tu cliente: admite 2025-11-25, 2025-06-18 y 2025-03-26.
Inicio rápido
1. Obtén una clave de API
Regístrate en nynch.com y luego ve a Configuración → Integraciones → Claude y Asistentes de IA para crear una clave de API.
Ámbitos:
read— Buscar, explorar y recuperar datosread-write— Lectura + creación, actualización y eliminación de registrosadmin— Acceso completo, incluida la orquestación de agentes
2. Configura tu cliente
Claude Desktop
Agrega a claude_desktop_config.json:
{
"mcpServers": {
"nynch": {
"url": "https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Cursor
Agrega a .cursor/mcp.json:
{
"mcpServers": {
"nynch": {
"url": "https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Python (SDK de 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. Comienza a usar las herramientas
Tu cliente de IA descubre automáticamente las herramientas disponibles. Pídele que busque contactos, revise tu canal de ventas, cree tareas o analice relaciones.
Catálogo de herramientas
Lectura de CRM (11 herramientas)
| Herramienta | Descripción |
|---|---|
search_contacts | Buscar contactos por nombre, empresa o etiquetas |
get_contact_context | Contexto completo del contacto: perfil, interacciones, actividades, notas, red |
search_deals | Buscar negocios por título, etapa o empresa |
get_deal_context | Contexto completo del negocio: partes interesadas, aprendizajes, acciones de coaching |
search_deals_by_inactivity | Encontrar negocios estancados sin actividad reciente |
get_pipeline_summary | Salud del canal: distribución por etapas, negocios en riesgo, cierres próximos |
get_next_best_actions | Recomendaciones impulsadas por IA sobre qué hacer a continuación |
get_who_list | Personas a contactar ahora, incluidos visitantes del sitio identificados. Nunca menciones una página específica en la divulgación |
list_buckets | Listar todos los buckets (listas/segmentos) |
get_bucket_contacts | Obtener contactos en un bucket específico |
get_bucket_game_queue | Obtener contactos pendientes de clasificar en buckets |
Escritura de CRM (12 herramientas)
| Herramienta | Descripción |
|---|---|
log_interaction | Registrar una interacción con un contacto (llamada, correo, reunión, nota) |
update_deal_stage | Mover un negocio a una nueva etapa del canal |
create_task | Crear una tarea vinculada a un contacto o negocio |
create_note | Agregar una nota a un contacto (admite markdown) |
create_contact | Crear un nuevo contacto (se vincula automáticamente a la empresa por dominio) |
update_contact | Actualizar campos en un contacto existente |
add_contact_to_bucket | Agregar un contacto a un bucket |
create_deal | Crear un nuevo negocio en el canal |
create_company | Crear una nueva empresa |
delete_contact | Eliminación suave de un contacto (recuperable) |
bulk_delete_contacts | Eliminación suave de contactos por etiqueta o lista de ID |
update_commitment | Marcar un compromiso como completado o actualizar detalles |
Inteligencia de relaciones (11 herramientas)
| Herramienta | Descripción |
|---|---|
get_authority_score | Puntaje de autoridad en 6 dimensiones |
get_commitments | Compromisos con seguimiento de Dicho/Hecho y fechas de vencimiento |
get_buying_committee | Mapa de partes interesadas: roles, influencia, sentimiento |
get_contact_signals | Cambios de empleo, cambios de empresa, intención de compra, visitas al sitio web identificadas (sin rutas de página) |
get_interaction_history | Línea de tiempo completa de interacciones con dirección y sentimiento |
get_relationship_score | Puntaje de fortaleza de relación de 5 factores |
export_context_briefing | Resumen de contexto listo para IA para cualquier contacto o negocio |
get_relationship_trends | ¿El compromiso está creciendo, estable o disminuyendo? |
get_at_risk_relationships | Contactos con puntajes en descenso o sin contacto reciente |
get_deal_intelligence | Salud del negocio: velocidad, cobertura de partes interesadas, factores de riesgo |
get_weekly_briefing | Resumen semanal: interacciones, cambios, recomendaciones |
Orquestación de agentes (8 herramientas)
| Herramienta | Descripción |
|---|---|
register_agent | Registrar un agente externo con capacidades y arquetipo |
list_agents | Listar agentes registrados con estado |
agent_heartbeat | Confirmar que un agente está activo |
write_context | Escribir en el almacén de contexto compartido de agentes |
read_context | Leer del almacén de contexto (admite comodines de prefijo) |
create_handoff | Solicitar a otro agente que realice una tarea |
get_handoffs | Obtener transferencias pendientes para tu agente |
complete_handoff | Marcar una transferencia como completada o fallida |
Consulta de contexto (5 herramientas)
Descubre y lee porciones acotadas del contexto de Nynch y de aplicaciones conectadas, priorizando metadatos. Solo lectura: nunca acepta SQL sin procesar.
| Herramienta | Descripción |
|---|---|
list_context_sources | Listar fuentes de contexto seguras de solo lectura disponibles para ti |
search_context_sources | Buscar fuentes de contexto por palabra clave en lenguaje natural (solo metadatos) |
describe_context_source | Describir una fuente: propósito, columnas, filtros, límites, disponibilidad |
list_context_columns | Listar columnas seleccionables y filtros permitidos para una fuente |
query_context | Leer una porción acotada de una fuente mediante un objeto de consulta restringido |
Recursos de MCP
| Plantilla de URI | Descripción |
|---|---|
nynch://contacts/{id} | Contexto completo del contacto: perfil, puntaje, interacciones, red |
nynch://deals/{id} | Contexto del negocio: detalles, partes interesadas, acciones de coaching |
nynch://pipeline/summary | Resumen de salud del canal |
Orquestación de agentes
Nynch admite flujos de trabajo multiagente donde los agentes de IA se registran, comparten contexto y transfieren tareas:
- Regístrate con un nombre, capacidades y arquetipo (productor, consumidor, coordinador, crítico)
- Comparte estado mediante un almacén de contexto clave-valor con espacios de nombres y TTL
- Enruta tareas por nombre de agente o coincidencia de capacidades
- Rastrea actividad con latidos
Límites de velocidad
- 1,000 solicitudes por hora por clave de API
Documentación
Documentación completa para desarrolladores: nynch.com/developers
Acerca de Nynch
Nynch es una plataforma de crecimiento impulsada por relaciones que ayuda a consultores y firmas de servicios profesionales a convertir relaciones en ingresos. Combina CRM, inteligencia de relaciones y coaching impulsado por IA en una sola plataforma.
Licencia
Este repositorio (documentación y configuración) se publica bajo la Licencia MIT. El servidor Nynch MCP en sí es un servicio alojado: no requiere instalación local.