> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/es/primeros-pasos/conectar-patagonai-mcp.md).

# Conecta Patagon AI con tu asistente de IA

Patagon AI MCP permite que un asistente de IA consulte de forma segura la información de Patagon AI a la que ya tienes acceso. Puedes preguntar sobre leads, conversaciones, agentes, rendimiento e informes usando lenguaje cotidiano.

## Antes de comenzar

Necesitas:

* Una cuenta activa de Patagon AI.
* Acceso a al menos una organización en Patagon AI.
* La dirección MCP de Patagon AI:

  ```
  https://api.patagon.ai/mcp
  ```

Cuando se te solicite iniciar sesión, usa tus credenciales habituales de Patagon AI. No necesitas una clave de API ni un token de acceso.

> Patagon AI MCP sigue las mismas reglas de acceso que la aplicación de Patagon AI. Solo verás las organizaciones y la información permitidas por tu rol. Si en la aplicación tu acceso está limitado a los leads o las conversaciones que tienes asignados, aquí se aplica el mismo límite. Los datos de contacto protegidos permanecen ocultos hasta que estén disponibles para ti en Patagon AI.

## ChatGPT

Primero, los administradores del workspace de ChatGPT deben habilitar Patagon AI como una aplicación personalizada. Si no ves las opciones que se indican a continuación, pídele a tu administrador de ChatGPT que complete estos pasos.

### Agregar Patagon AI al workspace

1. Abre **ChatGPT** en tu navegador.
2. Abre **Workspace settings**.
3. Ve a **Apps** y selecciona **Create**.
4. Si se te solicita, habilita **Developer mode**.
5. Asigna `Patagon AI` como nombre de la aplicación.
6. Ingresa `https://api.patagon.ai/mcp` como dirección del servidor MCP.
7. Elige la autenticación **OAuth**.
8. Selecciona **Scan tools** y completa el inicio de sesión de Patagon AI en la ventana que se abre.
9. Cuando finalice el escaneo, selecciona **Create**.
10. Publica o habilita la aplicación para las personas que deban usarla.

### Conectarse como miembro del workspace

1. Abre **Settings → Apps**.
2. Busca **Patagon AI** y selecciona **Connect**.
3. Inicia sesión en Patagon AI y aprueba la conexión.
4. Inicia un nuevo chat. Selecciona **+ → More** y habilita **Patagon AI**. También puedes mencionar `@Patagon AI` en tu prompt si aparece en la lista de aplicaciones.

## Aplicación de Codex

1. Abre la **aplicación de Codex**.
2. Abre **Settings → MCP servers**.
3. Selecciona **Add server**.
4. Ingresa `Patagon AI` como nombre.
5. Elige **Streamable HTTP**.
6. Ingresa `https://api.patagon.ai/mcp` como dirección del servidor y guarda la configuración.
7. Selecciona **Restart** cuando se te solicite.
8. Regresa a **Settings → MCP servers** y selecciona **Authenticate** junto a Patagon AI.
9. Inicia sesión en Patagon AI y aprueba la conexión.

Puedes escribir `/mcp` en una conversación de Codex para confirmar que Patagon AI está conectado.

### Alternativa desde la terminal de Codex

Si usas Codex desde una terminal, copia y ejecuta estos comandos:

```bash
codex mcp add patagonai --url https://api.patagon.ai/mcp
codex mcp login patagonai
```

Completa el inicio de sesión de Patagon AI en tu navegador y, luego, inicia una nueva conversación de Codex.

## Claude Code

Claude Code se ejecuta en una terminal, pero la configuración solo requiere un comando.

1. Copia y ejecuta:

   ```bash
   claude mcp add --transport http --scope user patagonai https://api.patagon.ai/mcp
   ```
2. Abre Claude Code ejecutando `claude`.
3. Escribe `/mcp`.
4. Selecciona **Patagon AI** y, luego, elige la opción para autenticarte.
5. Inicia sesión en Patagon AI en la ventana del navegador y aprueba la conexión.

Después de la configuración, Patagon AI estará disponible en tus conversaciones de Claude Code en esa computadora.

## Claude Cowork

### Planes personales de Claude

1. Abre Claude y ve a **Customize → Connectors**.
2. Selecciona **+** y, luego, **Add custom connector**.
3. Asigna `Patagon AI` como nombre.
4. Ingresa `https://api.patagon.ai/mcp` como dirección del servidor MCP remoto.
5. Selecciona **Add**, inicia sesión en Patagon AI y aprueba la conexión.
6. Abre Cowork. Usa el botón **+**, selecciona **Connectors** y habilita **Patagon AI** para tu conversación.

### Planes Claude Team o Enterprise

Primero, un Owner debe agregar Patagon AI para la organización:

1. Ve a **Organization settings → Connectors**.
2. Selecciona **Add**.
3. Coloca el cursor sobre **Custom** y selecciona **Web**.
4. Ingresa `https://api.patagon.ai/mcp` y selecciona **Add**.

Luego, cada miembro puede ir a **Customize → Connectors**, buscar **Patagon AI**, seleccionar **Connect** y completar el inicio de sesión de Patagon AI. En Cowork, habilítalo para una conversación desde **+ → Connectors**.

## Ejemplos simples para comenzar

Prueba con uno de estos prompts:

* `¿A qué organizaciones de Patagon AI tengo acceso?`
* `Muéstrame los leads que tengo asignados y que necesitan atención.`
* `Resume la conversación más reciente con este lead.`
* `¿Cómo se están desempeñando mis agentes? Explícamelo de forma sencilla.`
* `Dame un resumen breve para el gerente de ventas de esta semana.`
* `Crea un resumen sencillo del rendimiento de marketing.`

Si perteneces a más de una organización, incluye el nombre de la organización en tu solicitud. También puedes pedirle al asistente que primero te muestre tus organizaciones.

## Si la conexión no funciona

* **Patagon AI no aparece:** Confirma que el conector esté habilitado para el chat o la tarea de Cowork actuales.
* **No puedes agregar el conector:** Es posible que el administrador de tu workspace de ChatGPT o Claude deba habilitar las aplicaciones o los conectores personalizados.
* **La ventana de inicio de sesión no se abrió:** Regresa a la configuración de MCP o de conectores y vuelve a seleccionar **Authenticate** o **Connect**.
* **El navegador muestra un error de callback:** Regresa al asistente de IA. Es posible que el inicio de sesión ya se haya completado; de lo contrario, vuelve a intentar la autenticación.
* **Falta información:** Comprueba si puedes ver la misma organización, el mismo lead o la misma conversación en la aplicación de Patagon AI. MCP usa los mismos permisos.
* **Los datos de contacto están ocultos:** Esto es normal cuando se aplican las reglas de protección de contactos de Patagon AI.

Para desconectarte, elimina Patagon AI de la configuración de MCP o de conectores del asistente. Puedes volver a conectarte en cualquier momento usando la misma dirección.

## Referencias oficiales de configuración

* [Aplicaciones en ChatGPT](https://help.openai.com/en/articles/11487775-connectors-in)
* [Modo desarrollador y aplicaciones MCP en ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta)
* [MCP en Codex](https://learn.chatgpt.com/docs/extend/mcp)
* [MCP en Claude Code](https://code.claude.com/docs/en/mcp)
* [Conectores personalizados en Claude y Cowork](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.patagon.ai/es/primeros-pasos/conectar-patagonai-mcp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
