Servidor MCP (Model Context Protocol)

El Model Context Protocol (MCP) es un estándar abierto desarrollado por Anthropic que permite a modelos y asistentes de IA (como Claude Desktop, ChatGPT, Cursor o agentes autónomos personalizados) interactuar con herramientas, bases de datos y servicios empresariales externos mediante un protocolo unificado.

Parrot CRM ofrece un Servidor MCP Remoto Oficial desplegado en alta disponibilidad sobre Cloudflare Workers:

https://mcp.parrot.software/mcp

Con este servidor, tu asistente de IA puede consultar historiales de WhatsApp, crear prospectos, agendar actividades de seguimiento, actualizar etapas en el embudo y consultar tus políticas comerciales en tiempo real.

Seguridad y Autenticación OAuth 2.1

A diferencia de las integraciones tradicionales que requieren generar API keys estáticas y guardarlas en archivos locales, el servidor MCP de Parrot CRM utiliza OAuth 2.1 con PKCE:

Cero claves estáticas: No necesitas exponer contraseñas ni tokens fijos en tu disco duro.
Autenticación web interactiva: Al conectar tu cliente MCP por primera vez, se abrirá tu navegador para autenticarte con tus credenciales de Parrot y seleccionar tu espacio de trabajo (parrotId).
Aislamiento multi-inquilino: El servidor firma un token JWT compatible con CouchDB (main_<parrotId>), restringiendo todas las operaciones de tu agente estrictamente a los datos de tu empresa.
Tokens efímeros con rotación: Las sesiones expiran a los 7 días de inactividad y pueden revocarse en cualquier momento.

Configuración paso a paso por cliente

1. Claude Desktop

Abre el archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Agrega el servidor dentro de la clave mcpServers:

{
  "mcpServers": {
    "parrot-crm": {
      "url": "https://mcp.parrot.software/mcp"
    }
  }
}

Consejo: También puedes copiar este bloque directamente desde Configuración → pestaña Inteligencia Artificial → Servidor MCP dentro de tu Parrot CRM.

Reinicia Claude Desktop. En cuanto envíes tu primer mensaje consultando información de tu CRM, Claude te indicará que debes autorizar la conexión y abrirá la pantalla de autenticación en tu navegador predeterminado.

2. Cursor

Crea o edita el archivo .cursor/mcp.json en la raíz de tu proyecto (o agrégalo en la configuración global de Cursor en Settings → MCP → Add New MCP Server):

{
  "mcpServers": {
    "parrot-crm": {
      "url": "https://mcp.parrot.software/mcp"
    }
  }
}

3. ChatGPT (Custom GPTs / Agentes)

Para conectar ChatGPT o agentes que consumen acciones OpenAPI / MCP remotas:

Endpoint MCP: https://mcp.parrot.software/mcp
Descubrimiento OAuth 2.1: https://mcp.parrot.software/.well-known/oauth-authorization-server
Autorización: https://mcp.parrot.software/authorize
Tokens: https://mcp.parrot.software/oauth/token
Scopes: crm:read crm:write

4. Claude Code CLI

Para añadir el servidor MCP a la interfaz de línea de comandos de Claude Code, ejecuta en tu terminal:

claude mcp add parrot-crm https://mcp.parrot.software/mcp

Al invocar un comando o consulta que interactúe con Parrot CRM, se abrirá automáticamente la ventana de login en tu navegador.

5. Clientes y Frameworks Personalizados (LangChain, LlamaIndex, SDKs)

Para conectar runtimes en Python o TypeScript mediante el SDK oficial @modelcontextprotocol/sdk:

Protocolo de transporte: HTTP / Server-Sent Events (SSE).
Endpoint MCP: https://mcp.parrot.software/mcp
Descubrimiento OAuth: https://mcp.parrot.software/.well-known/oauth-authorization-server
Endpoint de autorización: https://mcp.parrot.software/authorize
Endpoint de tokens: https://mcp.parrot.software/oauth/token
Scopes requeridos: crm:read crm:write

Primer flujo de autorización

Cuando tu cliente se conecta por primera vez:

Redirección automática: El cliente detecta el endpoint de autorización y abre la URL https://mcp.parrot.software/authorize en tu navegador.
Inicio de sesión: Ingresas con tu usuario y contraseña de Parrot CRM.
Selección de Workspace: Si tu cuenta tiene acceso a múltiples licencias o empresas en Parrot CRM, podrás seleccionar a cuál deseas conectar este agente.
Confirmación: Al autorizar, serás redirigido de vuelta al cliente de IA con tu token temporal activo.

Capacidades Disponibles

El servidor MCP expone herramientas (Tools) y recursos de contexto (Resources):

Herramientas de Lectura (`read_crm`)

search: Busca prospectos, clientes, mensajes y FAQs por palabras clave.
get: Consulta el documento completo de un cliente, venta, hilo o recurso por su identificador.
timeline: Recupera el historial cronológico de mensajes omnicanal (WhatsApp, Messenger, correo).

Herramientas de Escritura (`write_crm`)

create_client y update_client: Registra nuevos contactos o actualiza datos existentes.
create_lead y update_lead: Da de alta oportunidades comerciales.
update_pipeline_stage: Mueve un prospecto de etapa en el embudo (Kanban).
add_note y create_activity: Documenta acuerdos, llamadas o tareas de seguimiento.
add_faq, update_faq, delete_faq: Administra preguntas frecuentes en la base de conocimientos.

Recursos de Conocimiento (`Resources`)

parrot://knowledge/business: Perfil de la empresa, métodos de pago, sucursales y políticas de garantía/envío.
parrot://knowledge/faqs: Preguntas frecuentes oficiales configuradas en el CRM.
parrot://knowledge/overview: Resumen general consolidado para dar contexto al modelo.

Utilidades

whoami: Valida la identidad del usuario conectado, rol y parrotId activo.
now: Retorna la fecha y hora UTC actual para calcular tiempos relativos (“ayer”, “hace 2 horas”, “el próximo viernes”).

Ejemplos de Prompts y Flujos de Trabajo

Una vez conectado, puedes interactuar de forma conversacional con tu cliente de IA:

1. Resumen matutino de WhatsApp

“¿Cuáles son los 5 prospectos que más interactuaron por WhatsApp en las últimas 24 horas y qué necesidades expresaron?”

Acción ejecutada: El agente invoca now y read_crm (timeline, search), analiza los mensajes y genera un briefing priorizado.

2. Actualización de Pipeline comercial

“Mueve al cliente Carlos Slim a la etapa ‘Cotización enviada’ y agenda una llamada de seguimiento para pasado mañana a las 11:00 AM.”

Acción ejecutada: El agente busca el prospecto con read_crm (search), actualiza la etapa con write_crm (update_pipeline_stage) y crea la tarea con write_crm (create_activity).

3. Asistencia con Políticas del Negocio

“Consulta nuestra política de envíos foráneos y redacta una respuesta lista para enviar al cliente en el hilo de Mariana López.”

Acción ejecutada: El agente lee el recurso parrot://knowledge/business, consulta el hilo con read_crm (timeline) y genera un mensaje personalizado adaptado al tono de la empresa.

Solución de Problemas Frecuentes

Mi token expiró o la sesión pide volver a autenticarse

Los tokens de sesión expiran tras 7 días de inactividad por seguridad. En Claude Desktop o Cursor, simplemente realiza una nueva consulta relacionada con el CRM para que el cliente reabra la ventana de login en tu navegador.

Conecté el espacio de trabajo equivocado

Si tienes múltiples empresas en Parrot CRM y autorizaste una diferente, puedes desautorizar el cliente eliminando la sesión o volviendo a conectar el servidor seleccionando la empresa correcta en la pantalla de autorización.

Claude Desktop no muestra las herramientas

Verifica que la sintaxis JSON en claude_desktop_config.json sea válida (sin comas sobrantes).
Asegúrate de reiniciar completamente la aplicación Claude Desktop (cerrar desde la barra de menú o Administrador de tareas).
Escribe en el chat: “Usa la herramienta whoami de Parrot CRM para verificar la conexión”.