> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piperai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP: conecta Piper con Claude, ChatGPT y otros asistentes de IA

> Conecta Piper AI con Claude, ChatGPT y otros asistentes de IA compatibles con MCP usando el servidor MCP de Piper, para poder preguntar sobre llamadas, negocios y contactos desde las herramientas que ya usas.

MCP (Model Context Protocol) es un estándar abierto que permite a los asistentes de IA conectarse directamente a los datos de Piper. A diferencia de las demás integraciones de Piper, MCP no se configura dentro de Piper: agregas a Piper como servidor MCP dentro de tu herramienta de IA (Claude, ChatGPT o cualquier otro cliente compatible con MCP), y luego lo autorizas con tu cuenta de Piper. Una vez conectado, puedes preguntarle a tu asistente de IA sobre tus llamadas, negocios y contactos sin salir de la herramienta en la que ya estás trabajando.

<Note>
  El acceso por MCP es de solo lectura. Los asistentes de IA conectados pueden buscar y leer tus llamadas, negocios, contactos y datos relacionados, pero no pueden hacer cambios en Piper en tu nombre.
</Note>

## Requisitos previos

* Una cuenta de Piper con sesión iniciada con tu cuenta de trabajo de Google o Microsoft
* Un asistente de IA que admita servidores MCP remotos con OAuth (por ejemplo, Claude o ChatGPT)

## El servidor MCP de Piper

|                     |                                                                                                                    |
| ------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Server URL**      | `https://mcp.piperai.com/mcp`                                                                                      |
| **Autorización**    | OAuth: inicia sesión con tu cuenta de Piper cuando se te solicite; no hay que generar ni gestionar ninguna API key |
| **Nivel de acceso** | Solo lectura, limitado a tu equipo de Piper                                                                        |

Puedes encontrar esta URL en cualquier momento en **Settings → Integrations → MCP & API Access** dentro de Piper.

## Conectar Claude

<Steps>
  <Step title="Abre la configuración de Connector">
    En Claude, ve a **Settings → Connectors** y elige agregar un conector personalizado.
  </Step>

  <Step title="Agrega la URL del servidor de Piper">
    Pega `https://mcp.piperai.com/mcp` y confirma.
  </Step>

  <Step title="Autoriza con tu cuenta de Piper">
    Claude abre una pantalla de inicio de sesión de Piper. Elige **Continue with Google** o **Continue with Microsoft** usando tu cuenta de trabajo de Piper, y luego aprueba el acceso.
  </Step>
</Steps>

<Tip>
  Los menús de conectores de Claude se actualizan de vez en cuando; si los pasos anteriores no coinciden con lo que ves, consulta la [documentación oficial de Anthropic](https://docs.claude.com) para conocer la ruta actual para agregar un conector personalizado.
</Tip>

## Conectar ChatGPT

<Steps>
  <Step title="Abre la configuración de Connector">
    En ChatGPT, ve a **Settings → Connectors** y elige agregar un conector personalizado.
  </Step>

  <Step title="Agrega la URL del servidor de Piper">
    Pega `https://mcp.piperai.com/mcp` y confirma.
  </Step>

  <Step title="Autoriza con tu cuenta de Piper">
    ChatGPT abre una pantalla de inicio de sesión de Piper. Elige **Continue with Google** o **Continue with Microsoft** usando tu cuenta de trabajo de Piper, y luego aprueba el acceso.
  </Step>
</Steps>

<Tip>
  Los menús de conectores de ChatGPT se actualizan de vez en cuando; si los pasos anteriores no coinciden con lo que ves, consulta la documentación oficial de OpenAI para conocer la ruta actual para agregar un conector personalizado.
</Tip>

## Conectar otros clientes MCP

La mayoría de las herramientas compatibles con MCP (por ejemplo, Cursor o Windsurf) te permiten agregar un servidor remoto por URL desde su configuración de MCP o de conectores. Agrega `https://mcp.piperai.com/mcp` como la URL del servidor, y completa el inicio de sesión OAuth con tu cuenta de Piper cuando aparezca. Consulta la documentación de tu herramienta específica para saber exactamente dónde se encuentra esta opción.

## Qué puede acceder tu asistente de IA

Una vez conectado, tu asistente de IA puede consultar:

| Dato               | Qué puede hacer                                                                                                                                                                                                                                                                                                                                                                               |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Transcriptions** | Listar y filtrar las llamadas de tu equipo (por usuario, rango de fechas, negocio, contacto, etiqueta o meeting type), y obtener la transcripción completa, los participantes y el resumen de una llamada específica — incluyendo, si se solicita, su call score, notas recientes, valores de campos de CRM, el correo de seguimiento redactado, y un enlace permanente para abrirla en Piper |
| **Deals**          | Buscar negocios por nombre, para referenciarlos o filtrarlos en una consulta                                                                                                                                                                                                                                                                                                                  |
| **Contacts**       | Buscar contactos por nombre o correo, para referenciarlos o filtrarlos en una consulta                                                                                                                                                                                                                                                                                                        |
| **Meeting Types**  | Listar los meeting types configurados en tu equipo                                                                                                                                                                                                                                                                                                                                            |
| **Tags**           | Listar las etiquetas disponibles en tu equipo                                                                                                                                                                                                                                                                                                                                                 |
| **Users**          | Listar los usuarios de tu equipo                                                                                                                                                                                                                                                                                                                                                              |

<Note>
  El acceso está limitado a tu equipo de Piper: tu asistente de IA solo ve las llamadas y registros visibles para tu cuenta, según las mismas reglas de compartición que aplican dentro de Piper.
</Note>

### Ejemplos de preguntas que puedes hacer

* "¿Qué llamadas tuve recientemente con \[nombre de contacto o empresa]?"
* "Resume mi última llamada sobre \[nombre del negocio]."
* "Muéstrame todas las llamadas etiquetadas '\[nombre de la etiqueta]' de este trimestre."
* "Lista los meeting types de mi equipo."

## Desconectar

Para revocar el acceso de un asistente de IA, elimina la conexión con Piper desde la configuración de conectores o integraciones de tu herramienta de IA.