Pular para o conteúdo principal

Servidor MCP da Copera

O servidor MCP da Copera é um endpoint hospedado de Model Context Protocol que permite que clientes de IA — Claude Desktop, Claude Code, Cursor e qualquer outra ferramenta com suporte a MCP — leiam e escrevam no seu workspace Copera diretamente. Ele expõe as mesmas capacidades da Copera Public API, empacotadas como ferramentas MCP nativas que um agente pode descobrir e chamar.

Você aponta seu cliente de IA para uma única URL, autentica com um token, e o modelo ganha um catálogo de 37 ferramentas abrangendo boards, documentos, busca, chat, notificações, drive, comentários e exportações.

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)

Como ele se relaciona com a Public API​

O servidor MCP é um proxy fino e sem estado sobre a Copera Public API. Cada chamada de ferramenta vira uma requisição HTTP tipada para https://api.copera.ai/public/v1/*, encaminhando seu token. O servidor não mantém nenhum estado de sessão e não armazena dados próprios — seu token é validado pela Public API exatamente como seria em uma chamada REST direta.

Isso significa que o servidor MCP herda o modelo de permissões, os limites de taxa e o comportamento da Public API. Se você consegue fazer algo com um Personal Access Token via REST, você consegue fazê-lo através do MCP — e um cliente de IA recebe isso como uma ferramenta que já sabe usar.

Mesmas capacidades, entrega nativa para IA

O servidor MCP não adiciona novas capacidades sobre a Public API — ele as espelha. Escolha o MCP quando um cliente de IA é o consumidor; escolha a REST API ou a CLI para scripts e integrações.

Paridade e lacunas atuais​

O catálogo de ferramentas MCP acompanha de perto a Public API, mas não é um mapeamento um-para-um de cada endpoint. Algumas capacidades da Public API não têm ferramenta MCP hoje:

  • Markdown no nível de coluna da linha via um endpoint dedicado além da superfície set_row_markdown / get_row_markdown.
  • Autenticação de linha (o endpoint de autenticação de linha de tabela).
  • Upload multipart no drive (início/finalização de upload multipart pré-assinado) — as ferramentas de drive do MCP leem e criam pastas, mas não fazem upload dos bytes dos arquivos.
  • Bookings — nenhuma ferramenta MCP é exposta para a superfície de Bookings.

Para a matriz completa de capacidades através da Public API, MCP, CLI e ferramentas de Copera AI, veja a visão geral de paridade.

Quais clientes de IA podem usá-lo​

Qualquer cliente que fale o transporte MCP Streamable HTTP pode se conectar, incluindo:

  • Claude Desktop e Claude Code (via um servidor / conector MCP remoto)
  • Cursor
  • O MCP Inspector para testes e depuração manuais
  • Qualquer agente customizado construído sobre um MCP SDK

Próximos passos​

Conectar um cliente

URL do endpoint, configuração do cliente e testes com o MCP Inspector.

Autenticação

Personal Access Tokens vs. OAuth, o fluxo OAuth e como os escopos mapeiam para ferramentas.

Referência de ferramentas

Todas as 37 ferramentas agrupadas por domínio, com a capacidade da Public API a que cada uma mapeia.

Casos de uso

Workflows concretos de agentes e sequências de exemplo de chamadas de ferramentas.