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 datos
  • read-write — Lectura + creación, actualización y eliminación de registros
  • admin — 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)

HerramientaDescripción
search_contactsBuscar contactos por nombre, empresa o etiquetas
get_contact_contextContexto completo del contacto: perfil, interacciones, actividades, notas, red
search_dealsBuscar negocios por título, etapa o empresa
get_deal_contextContexto completo del negocio: partes interesadas, aprendizajes, acciones de coaching
search_deals_by_inactivityEncontrar negocios estancados sin actividad reciente
get_pipeline_summarySalud del canal: distribución por etapas, negocios en riesgo, cierres próximos
get_next_best_actionsRecomendaciones impulsadas por IA sobre qué hacer a continuación
get_who_listPersonas a contactar ahora, incluidos visitantes del sitio identificados. Nunca menciones una página específica en la divulgación
list_bucketsListar todos los buckets (listas/segmentos)
get_bucket_contactsObtener contactos en un bucket específico
get_bucket_game_queueObtener contactos pendientes de clasificar en buckets

Escritura de CRM (12 herramientas)

HerramientaDescripción
log_interactionRegistrar una interacción con un contacto (llamada, correo, reunión, nota)
update_deal_stageMover un negocio a una nueva etapa del canal
create_taskCrear una tarea vinculada a un contacto o negocio
create_noteAgregar una nota a un contacto (admite markdown)
create_contactCrear un nuevo contacto (se vincula automáticamente a la empresa por dominio)
update_contactActualizar campos en un contacto existente
add_contact_to_bucketAgregar un contacto a un bucket
create_dealCrear un nuevo negocio en el canal
create_companyCrear una nueva empresa
delete_contactEliminación suave de un contacto (recuperable)
bulk_delete_contactsEliminación suave de contactos por etiqueta o lista de ID
update_commitmentMarcar un compromiso como completado o actualizar detalles

Inteligencia de relaciones (11 herramientas)

HerramientaDescripción
get_authority_scorePuntaje de autoridad en 6 dimensiones
get_commitmentsCompromisos con seguimiento de Dicho/Hecho y fechas de vencimiento
get_buying_committeeMapa de partes interesadas: roles, influencia, sentimiento
get_contact_signalsCambios de empleo, cambios de empresa, intención de compra, visitas al sitio web identificadas (sin rutas de página)
get_interaction_historyLínea de tiempo completa de interacciones con dirección y sentimiento
get_relationship_scorePuntaje de fortaleza de relación de 5 factores
export_context_briefingResumen de contexto listo para IA para cualquier contacto o negocio
get_relationship_trends¿El compromiso está creciendo, estable o disminuyendo?
get_at_risk_relationshipsContactos con puntajes en descenso o sin contacto reciente
get_deal_intelligenceSalud del negocio: velocidad, cobertura de partes interesadas, factores de riesgo
get_weekly_briefingResumen semanal: interacciones, cambios, recomendaciones

Orquestación de agentes (8 herramientas)

HerramientaDescripción
register_agentRegistrar un agente externo con capacidades y arquetipo
list_agentsListar agentes registrados con estado
agent_heartbeatConfirmar que un agente está activo
write_contextEscribir en el almacén de contexto compartido de agentes
read_contextLeer del almacén de contexto (admite comodines de prefijo)
create_handoffSolicitar a otro agente que realice una tarea
get_handoffsObtener transferencias pendientes para tu agente
complete_handoffMarcar 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.

HerramientaDescripción
list_context_sourcesListar fuentes de contexto seguras de solo lectura disponibles para ti
search_context_sourcesBuscar fuentes de contexto por palabra clave en lenguaje natural (solo metadatos)
describe_context_sourceDescribir una fuente: propósito, columnas, filtros, límites, disponibilidad
list_context_columnsListar columnas seleccionables y filtros permitidos para una fuente
query_contextLeer una porción acotada de una fuente mediante un objeto de consulta restringido

Recursos de MCP

Plantilla de URIDescripció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/summaryResumen 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.