Saltar al contenido principal

Servidor MCP de Copera

El servidor MCP de Copera es un endpoint alojado de Model Context Protocol que permite a los clientes de IA — Claude Desktop, Claude Code, Cursor y cualquier otra herramienta compatible con MCP — leer y escribir directamente en tu workspace de Copera. Expone las mismas capacidades que la Copera Public API, empaquetadas como herramientas MCP nativas que un agente puede descubrir y llamar.

Apuntas tu cliente de IA a una sola URL, te autenticas con un token y el modelo obtiene un catálogo de 37 herramientas que abarcan boards, documentos, búsqueda, chat, notificaciones, drive, comentarios y exportaciones.

AI client (Claude / Cursor / …)
  │  MCP over Streamable HTTP, Authorization: Bearer cp_pat_… or cp_oat_…
  ▼
Copera MCP server  (https://mcp.copera.ai/mcp)
  │  each tool call → HTTPS request to the Public API
  ▼
Copera Public API  (https://api.copera.ai/public/v1)

Cómo se relaciona con la Public API​

El servidor MCP es un proxy delgado y sin estado sobre la Copera Public API. Cada llamada a una herramienta se convierte en una petición HTTP tipada a https://api.copera.ai/public/v1/*, reenviando tu token. El servidor no mantiene estado de sesión ni almacena datos propios — tu token es validado por la Public API exactamente igual que en una llamada REST directa.

Esto significa que el servidor MCP hereda el modelo de permisos, los límites de tasa y el comportamiento de la Public API. Si puedes hacer algo con un Personal Access Token sobre REST, puedes hacerlo a través de MCP — y un cliente de IA lo recibe como una herramienta que ya sabe cómo usar.

Mismas capacidades, entrega nativa para IA

El servidor MCP no agrega nuevas capacidades sobre la Public API — las refleja. Elige MCP cuando el consumidor es un cliente de IA; elige la REST API o la CLI para scripts e integraciones.

Paridad y brechas actuales​

El catálogo de herramientas MCP sigue de cerca a la Public API, pero no es un mapeo uno a uno de cada endpoint. Algunas capacidades de la Public API no tienen herramienta MCP hoy:

  • Markdown a nivel de columna de fila mediante un endpoint dedicado más allá de la superficie set_row_markdown / get_row_markdown.
  • Autenticación de fila (el endpoint de autenticación de fila de tabla).
  • Carga multipart en Drive (inicio/finalización de carga multipart con URL prefirmada) — las herramientas de drive de MCP leen y crean carpetas, pero no suben los bytes de los archivos.
  • Bookings — no se exponen herramientas MCP para la superficie de Bookings.

Para ver la matriz completa de capacidades entre la Public API, MCP, CLI y las herramientas de Copera AI, consulta el resumen de paridad.

Qué clientes de IA pueden usarlo​

Cualquier cliente que hable el transporte Streamable HTTP de MCP puede conectarse, incluyendo:

  • Claude Desktop y Claude Code (mediante un servidor MCP remoto / connector)
  • Cursor
  • El MCP Inspector para pruebas y depuración manuales
  • Cualquier agente personalizado construido sobre un SDK de MCP

Próximos pasos​

Conectar un cliente

URL del endpoint, configuración del cliente y pruebas con el MCP Inspector.

Autenticación

Personal Access Tokens vs. OAuth, el flujo de OAuth y cómo los scopes mapean a las herramientas.

Referencia de herramientas

Las 37 herramientas agrupadas por dominio, con la capacidad de la Public API que mapea cada una.

Casos de uso

Flujos de trabajo concretos de agentes y secuencias de ejemplo de llamadas a herramientas.