Aller au contenu principal

Copera MCP Cloud

Copera MCP Cloud est un endpoint hébergé Model Context Protocol qui permet aux clients IA — Claude Desktop, Claude Code, Cursor, et tout autre outil compatible MCP — de lire et écrire directement dans votre workspace Copera. Il expose les mêmes capacités que la Copera Public API, empaquetées en outils MCP natifs qu'un agent peut découvrir et appeler.

Vous pointez votre client IA vers une URL, vous vous authentifiez avec un token, et le modèle obtient un catalogue de 37 outils couvrant boards, documents, search, chat, notifications, drive, commentaires et exports.

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

Lien avec la Public API​

Copera MCP Cloud est un proxy léger et sans état au-dessus de la Copera Public API. Chaque appel d'outil devient une requête HTTP typée vers https://api.copera.ai/public/v1/*, en transmettant votre token. Le service ne conserve aucun état de session et ne stocke aucune donnée propre — votre token est validé par la Public API exactement comme pour un appel REST direct.

Cela signifie que Copera MCP Cloud hérite du modèle de permissions, des limites de débit et du comportement de la Public API. Si vous pouvez faire quelque chose avec un Personal Access Token en REST, vous pouvez le faire via MCP — et un client IA l'obtient comme un outil qu'il sait déjà utiliser.

Mêmes capacités, livraison native IA

Copera MCP Cloud n'ajoute pas de nouvelles capacités au-dessus de la Public API — il les reflète. Choisissez MCP lorsqu'un client IA est le consommateur ; choisissez l'API REST ou la CLI pour les scripts et intégrations.

Parité et écarts actuels​

Le catalogue d'outils MCP suit de près la Public API, mais ce n'est pas une correspondance un pour un de chaque endpoint. Quelques capacités de la Public API n'ont aucun outil MCP aujourd'hui :

  • Markdown au niveau colonne de ligne via un endpoint dédié au-delà de la surface set_row_markdown / get_row_markdown.
  • Authentification de ligne (l'endpoint d'authentification de ligne de table).
  • Upload multipart Drive (démarrage/finalisation d'upload multi-part pré-signé) — les outils drive MCP lisent et créent des dossiers mais n'envoient pas d'octets de fichier.
  • Bookings — aucun outil MCP n'est exposé pour la surface Bookings.

Pour la matrice complète des capacités entre Public API, MCP, CLI et outils Copera AI, voir la vue d'ensemble de la parité.

Quels clients IA peuvent l'utiliser​

Tout client qui parle le transport MCP Streamable HTTP peut se connecter, y compris :

  • Claude Desktop et Claude Code (via un serveur MCP distant / connecteur)
  • Cursor
  • The MCP Inspector pour les tests manuels et le débogage
  • Tout agent personnalisé construit sur un SDK MCP

Prochaines étapes​

Connecter un client

URL de l'endpoint, configuration client, et tests avec le MCP Inspector.

Authentification

Personal Access Tokens vs. OAuth, le flux OAuth, et le mapping des scopes aux outils.

Référence des outils

Les 37 outils regroupés par domaine, avec la capacité Public API à laquelle chacun correspond.

Cas d'usage

Workflows d'agents concrets et exemples de séquences d'appels d'outils.