Conecta tus agentes de IA con Parrotfy

Con el servidor MCP de Parrotfy, tu asistente de IA favorito (Claude, ChatGPT, Cursor y más) puede consultar y operar los datos de tu empresa directamente desde tu conversación.

¿Qué es el MCP de Parrotfy?

MCP (Model Context Protocol) es un estándar abierto que conecta tu herramienta de IA con sistemas externos. El servidor MCP de Parrotfy expone tu información de Parrotfy —clientes, productos, operaciones, finanzas— como un conjunto de herramientas que tu agente de IA puede usar de forma segura, sin que tengas que salir del chat.

Una vez conectado, puedes pedirle cosas como «muéstrame mis últimas órdenes de trabajo» o «¿cuál es el saldo de este cliente?» y la IA responderá usando tus datos reales de Parrotfy.

Antes de empezar

• Una cuenta activa de Parrotfy con permisos de administrador.

• Un agente de IA compatible: claude.ai, ChatGPT, Notion, Cursor o Claude Code (y cualquier otro agente que soporte MCP por HTTP).

• Tu Token de acceso personal de Parrotfy (lo generas en el Paso 1).

Paso 1 · Genera tu Token de acceso personal

1. En tu panel de Parrotfy, ve a Mi empresa → Integraciones.

2. Abre la pestaña API y MCP.

3. En la sección Token API V2, haz clic en + Nuevo Token.

4. Asígnale un nombre (por ejemplo, mi-asistente) y créalo.

5. Copia el token —comienza con ptfy_— y guárdalo en un lugar seguro.

Trátalo como una contraseña. Tu token da acceso a los datos de tu empresa. No lo compartas ni lo publiques. Puedes revocarlo o rotarlo cuando quieras desde la columna Acciones de esa misma tabla.

Paso 2 · Conéctalo a tu herramienta de IA

Hay dos formas de conectar tu asistente:

• OAuth (método predeterminado): compatible con la gran mayoría de los agentes de IA actuales — ChatGPT, Notion, Cursor, Claude Code y más. Solo agregas la dirección del servidor y autorizas el acceso desde una pantalla de Parrotfy, sin pegar el token en ningún archivo.

• Conexión JSON: para los agentes que no soportan OAuth, o si prefieres configurar la conexión manualmente con tu token —lo más habitual en entornos de desarrollo—.

Método predeterminado · OAuth (compatible con la mayoría de los agentes)

La gran mayoría de los agentes de IA soportan OAuth: basta con agregar la dirección del servidor y autorizar el acceso desde una pantalla de Parrotfy, sin configurar nada más.

1. En tu asistente, agrega un conector (o servidor MCP) con esta dirección: https://bot.parrotfy.com/mcp

2. Al conectar se abrirá la pantalla de inicio de sesión de Parrotfy. Ingresa tu Host de Parrotfy (por ejemplo, https://tu-empresa.parrotfy.com) y tu Token de acceso personal ptfy_… (puedes copiarlos desde la página API y MCP).

3. Autoriza el acceso. La conexión queda lista y el asistente ya puede usar las herramientas de tu Parrotfy.

💡 Sugerencia: la mayoría de los asistentes pueden agregar esta conexión por sí mismos o guiarte para hacerlo. Solo pídele «agrega este servidor MCP» con la dirección https://bot.parrotfy.com/mcp.

Guías rápidas para los asistentes más comunes:

Claude (claude.ai)

1. Abre el menú de tu perfil y entra a Configuración.

2. Ve a la sección Conectores.

3. Haz clic en Agregar → Agregar conector personalizado.

4. Asígnale un nombre (por ejemplo, Parrotfy) e ingresa la URL https://bot.parrotfy.com/mcp (no necesitas la configuración avanzada). Confirma con Agregar.

5. Haz clic en Conectar.

6. Se abrirá la pantalla de Parrotfy: ingresa tu Host de Parrotfy y tu Token de acceso personal, y autoriza el acceso.

ChatGPT

En ChatGPT, los servidores MCP se agregan como una aplicación con el modo de desarrollador activado:

1. Abre el menú de tu perfil y entra a Configuración.

2. Ve a la sección Aplicaciones y abre la configuración avanzada.

3. Activa el Modo de desarrollador.

4. Haz clic en Crear aplicación.

5. Asígnale un nombre (por ejemplo, MCP de Parrotfy). En Conexión, elige URL del servidor e ingresa https://bot.parrotfy.com/mcp; en Autenticación, selecciona OAuth. Marca Entiendo y quiero continuar y haz clic en Crear.

6. Se abrirá la pantalla de Parrotfy: ingresa tu Host de Parrotfy y tu Token de acceso personal, y autoriza el acceso.

7. Recomendado: en los Permisos de la aplicación, deja Preguntar siempre para confirmar cada acción antes de ejecutarla.

Conexión JSON · Para agentes sin OAuth o configuración manual

Usa este método si tu agente no soporta OAuth, o si prefieres configurar la conexión manualmente con tu token —lo más habitual en entornos de desarrollo, con herramientas como Cursor o Claude Code—. Indícale a tu agente la URL del servidor de Parrotfy y los dos headers de autenticación. Parrotfy genera automáticamente este bloque JSON con tu token ya rellenado en la pestaña API y MCP:

{
  "mcpServers": {
    "parrotfy": {
      "type": "streamable-http",
      "url": "https://bot.parrotfy.com/mcp",
      "headers": {
        "X-Parrotfy-Host": "https://tu-empresa.parrotfy.com",
        "Authorization": "Bearer ptfy_TU_TOKEN_AQUI"
      }
    }
  }
}

Copia siempre el bloque desde tu panel. Incluye tu token real y el nombre exacto de los headers. En los ejemplos verás ptfy_TU_TOKEN_AQUI y https://tu-empresa.parrotfy.com como marcadores: reemplázalos por los valores de tu cuenta (o, mejor, pega el bloque completo tal cual lo copiaste).

Cursor

1. Abre (o crea) el archivo ~/.cursor/mcp.json para todos tus proyectos, o .cursor/mcp.json dentro de un proyecto específico.

2. Pega el bloque JSON tal como lo copiaste de tu panel.

Guarda. En Cursor → Settings → MCP verás parrotfy con un punto verde (activo).

Claude Code (CLI)

Desde tu terminal, ejecuta un solo comando (reemplaza el token y el host por los de tu panel):

claude mcp add --transport http parrotfy https://bot.parrotfy.com/mcp \
  --header "Authorization: Bearer ptfy_TU_TOKEN_AQUI" \
  --header "X-Parrotfy-Host: https://tu-empresa.parrotfy.com"

Verifica con claude mcp list. Deberías ver parrotfy con estado ✓ Connected.

Otros agentes

¿Tu agente no aparece en este artículo? Prueba primero con OAuth (el método predeterminado): agrega la dirección https://bot.parrotfy.com/mcp y, si tu agente es compatible, la pantalla de Parrotfy se abrirá automáticamente. Si no soporta OAuth, cualquier agente MCP por HTTP (streamable-http) con headers personalizados puede conectarse con el mismo bloque JSON de tu panel:

Seguridad y buenas prácticas

• Tu token equivale a acceso a los datos de tu empresa: trátalo como una contraseña.

• No lo compartas por chat ni lo subas a repositorios públicos.

• Puedes revocar o rotar un token cuando quieras desde Integraciones → API y MCP → Acciones.

• Cuando tu agente lo permita, activa la confirmación humana antes de ejecutar herramientas.

• Ten precaución al usar el MCP de Parrotfy junto a otros servidores MCP, para evitar ataques de prompt injection.

• Con la conexión JSON, el nombre de cada header debe coincidir exactamente con el que muestra tu panel.

¿Problemas?

Preguntas relacionadas

• ¿Cómo conecto Claude / ChatGPT / Cursor a Parrotfy?

• ¿Qué es el MCP de Parrotfy y para qué sirve?

• ¿Dónde genero mi Token API de Parrotfy?

• ¿Qué hago si mi agente de IA no soporta OAuth?

• Me aparece «Token inválido» al conectar el MCP.