# Circleback MCP (/docs/es/support/platform/circleback-mcp)

El servidor Model Context Protocol (MCP) de Circleback ofrece una interfaz estandarizada que permite que cualquier app de IA compatible, como Claude y ChatGPT, acceda a tus datos de Circleback de forma simple y segura.

Una vez conectado, tu asistente de IA puede buscar y acceder a tus reuniones, correos electrónicos, eventos de calendario y más, todo sin salir de tu app de IA. Así ya no necesitas copiar y pegar entre Circleback y otras apps de IA.

El servidor MCP sigue la [especificación de MCP](https://modelcontextprotocol.io/specification/2025-03-26) remota con autenticación, por lo que el servidor está alojado y administrado de forma centralizada.

## Configuración

### General

El servidor MCP de Circleback admite transportes Streamable HTTP. Usa OAuth para la autenticación en [`https://circleback.ai/api/mcp`](https://circleback.ai/api/mcp), con registro dinámico de clientes o documentos de metadatos de ID de cliente.

Los administradores del espacio de trabajo también pueden configurar [Enterprise-Managed Authorization](/docs/support/security/enterprise-managed-authorization) para administrar el acceso de los miembros a Circleback MCP desde su proveedor de identidad.

### Claude⁠

1. Ve a **Configuración** desde la barra lateral en la web o en la app de escritorio
2. Selecciona **Conectores** en la barra lateral de configuración y haz clic en **Browse connectors**
3. Busca Circleback y haz clic en **+** para conectarlo

### ChatGPT

Conecta la app de Circleback para ChatGPT [aquí](https://chatgpt.com/apps/circleback/asdk_app_695308f21c648191a0dd48dc9965f4bb). Una vez conectada, ChatGPT consultará Circleback automáticamente cuando sea relevante, por ejemplo, cuando preguntes sobre reuniones o conversaciones.

También puedes agregar Circleback explícitamente en tu mensaje para asegurarte de que se use.

### Raycast

Haz clic [aquí](raycast://mcp/install?%7B%22name%22%3A%22Circleback%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//circleback.ai/api/mcp%22%7D) para instalar el servidor MCP de Circleback en Raycast.

En la búsqueda principal, en AI Commands o en AI Chat, escribe @circleback para mencionar y usar las herramientas que ofrece Circleback MCP.

### Claude Code

1. Abre tu terminal y ejecuta el siguiente comando
   ```
   claude mcp add --transport http circleback https://circleback.ai/api/mcp
   ```
2. Ejecuta `/mcp` una vez que hayas abierto una sesión de Claude Code para completar el flujo de autenticación

### Cursor

Haz clic [aquí](https://cursor.com/marketplace/cursor/circleback) para agregar el plugin de Circleback desde el Cursor Marketplace.

### Codex

Los pasos de configuración son los mismos tanto si usas la extensión para IDE como la CLI, ya que la configuración es compartida.

#### Configuración mediante la CLI

1. Ejecuta el siguiente comando en la Terminal
   ```
   codex mcp add circleback --url https://circleback.ai/api/mcp
   ```
   Esto te pedirá automáticamente que inicies sesión con tu cuenta de Circleback y la conectes a Codex.\
   \
   **Nota**: Si es la primera vez que usas un MCP en Codex, tendrás que activar la función `rmcp` para que esto funcione. Agrega lo siguiente a tu `~/.codex/config.toml`
   ```
   [features]
   experimental_use_rmcp_client = true
   ```

#### Configuración mediante variables de entorno

1. Abre el archivo `~/.codex/config.toml` en tu editor preferido y agrega lo siguiente

   ```
   [features]
   experimental_use_rmcp_client = true

   [mcp_servers.circleback]
   url = "https://circleback.ai/api/mcp"
   ```

2. Ejecuta `codex mcp login circleback` para completar el flujo de autenticación

## Qué puedes hacer

El servidor MCP de Circleback tiene herramientas para buscar, leer y actualizar tus datos de Circleback, agrupadas a continuación según aquello con lo que trabajan.

### Reuniones

- **SearchMeetings**: Busca reuniones por palabra clave, rango de fechas, etiquetas, asistente, dominio, propiedad o carpeta. Con una palabra clave, la primera página también incluye las reuniones cuyas transcripciones coinciden, y cada reunión muestra los fragmentos coincidentes de su transcripción con marcas de tiempo.
- **ReadMeetings**: Obtén información detallada de reuniones específicas, incluidas las notas, tus notas privadas, los asistentes, las tareas, los insights, las etiquetas, las carpetas y la duración.
- **UpdateMeeting**: Actualiza el nombre, las notas, tus notas privadas, las etiquetas o las carpetas de una reunión.
- **ShareMeeting**: Comparte una reunión con una persona, un equipo, el espacio de trabajo o cualquier persona que tenga el enlace, o quita el acceso.
- **DisplayMeetings**: Muestra las reuniones seleccionadas como tarjetas en las que puedes hacer clic para abrirlas en Circleback, en las apps de IA compatibles con MCP Apps. Las demás apps las reciben como texto.

### Transcripciones

- **GetTranscriptsForMeetings**: Obtén la transcripción completa de una o más reuniones, con etiquetas de hablantes y marcas de tiempo.

### Tareas

- **SearchActionItems**: Busca tareas por palabra clave, estado (pendiente o completada), responsable, etiqueta, dominio o rango de fechas.
- **CreateActionItem**: Crea una tarea, opcionalmente con una descripción o vinculada a una reunión. Se te asigna a ti, a menos que indiques a otra persona o pidas dejarla sin asignar.
- **UpdateActionItem**: Actualiza el título, la descripción, el estado o el responsable de una tarea.
- **DeleteActionItem**: Elimina una tarea.
- **DisplayActionItems**: Muestra las tareas seleccionadas como una lista de verificación que puedes marcar y reasignar, en las apps de IA compatibles con MCP Apps. Las demás apps las reciben como texto.

### Calendario

- **SearchCalendarEvents**: Busca eventos de calendario próximos y pasados, incluidos los asistentes, los enlaces de reunión y el estado de unión.
- **UpdateCalendarEvent**: Actualiza las notas privadas o las etiquetas de una reunión antes de que empiece.
- **DisplayCalendarEvents**: Muestra los próximos eventos de calendario como tarjetas con un interruptor para indicar si Circleback se une, en las apps de IA compatibles con MCP Apps. Las demás apps los reciben como texto.

### Correos electrónicos

- **SearchEmails**: Busca hilos en las cuentas de correo electrónico conectadas por palabra clave, remitente, destinatario o rango de fechas.

### Personas y empresas

- **FindProfiles**: Busca personas por nombre para obtener su correo electrónico, cargo y empresa.
- **FindCompanies**: Busca empresas por nombre o dominio.

### Etiquetas

- **ListTags**: Enumera todas las etiquetas de tu espacio de trabajo, útil para filtrar reuniones, transcripciones o tareas.
- **CreateTag**, **UpdateTag**, **DeleteTag**: Crea, cambia el nombre, cambia el color o elimina etiquetas.

### Carpetas

- **ListFolders**: Enumera las carpetas que puedes ver en tu espacio de trabajo, con sus ID.
- **ReadFolders**: Obtén los miembros, los equipos y las reglas de una carpeta.
- **CreateFolder**, **UpdateFolder**, **DeleteFolder**: Crea, cambia el nombre, cambia las reglas o elimina carpetas.
- **ShareFolder**: Comparte una carpeta con una persona, un equipo, el espacio de trabajo o cualquier persona que tenga el enlace, cambia su acceso o quítalos.

### Espacio de trabajo

- **ListTeams**: Enumera tu espacio de trabajo y sus equipos, con los ID para compartir.

### Soporte

- **SearchSupportArticles**: Busca en la documentación de soporte de Circleback ayuda y guías prácticas.
- **SubmitFeedback**: Envía comentarios, un informe de error o una solicitud de función al equipo de Circleback.

## Acceso de escritura

Las herramientas que hacen cambios, como crear o eliminar una tarea, necesitan acceso de escritura. Circleback lo solicita cuando te conectas, y tu app de IA aún puede pedirte que confirmes cada cambio. Si te conectaste antes de que estas herramientas estuvieran disponibles, desconecta y vuelve a conectar Circleback en tu app de IA para otorgar acceso de escritura.

De forma predeterminada, al conectarte se otorga acceso de lectura y escritura (`scope=user user:write`). Si tu app solo necesita acceso de lectura, envía `scope=user` en la solicitud de autorización. En ese caso, las herramientas que hacen cambios devuelven un error que le pide al usuario que vuelva a conectarse con acceso de escritura.