Connecter un client MCP

Copera MCP Cloud est accessible via un seul endpoint Streamable HTTP. Pointez votre client IA vers lui, fournissez un bearer token, et le catalogue d'outils apparaît automatiquement.

Endpoint


Endpoint MCP	`https://mcp.copera.ai/mcp`
Transport	Streamable HTTP (`POST`)
En-tête d'auth	`Authorization: Bearer cp_pat_…` ou `cp_oat_…`

Transport sans état

Le serveur fonctionne en mode sans état — il n'y a pas de sessions à reprendre. Seul POST /mcp est pris en charge ; GET et DELETE renvoient 405. Un health check est disponible sur GET /health.

Vous aurez besoin d'un token avant de vous connecter. L'option la plus simple est un Personal Access Token (cp_pat_…) créé dans les paramètres de votre workspace Copera. Voir Authentification pour PAT vs. OAuth et le mapping des scopes aux outils.

Connecter un client

Créer un token

Générez un Personal Access Token (cp_pat_…) dans votre workspace Copera et accordez-lui les scopes dont votre agent a besoin — par exemple access_boards et access_docs. Traitez-le comme un mot de passe.

Ajouter le serveur à votre client MCP

Configurez votre client avec l'URL de l'endpoint et le bearer token. La plupart des clients acceptent soit un bloc de configuration de serveur distant, soit une commande bridge mcp-remote.

Serveur distant (JSON)
Pont mcp-remote

{
  "mcpServers": {
    "copera": {
      "type": "http",
      "url": "https://mcp.copera.ai/mcp",
      "headers": {
        "Authorization": "Bearer cp_pat_YOUR_TOKEN_HERE"
      }
    }
  }
}

Pour les clients qui ne prennent en charge que des serveurs stdio locaux, reliez l'endpoint distant avec mcp-remote :

{
  "mcpServers": {
    "copera": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.copera.ai/mcp",
        "--header",
        "Authorization: Bearer cp_pat_YOUR_TOKEN_HERE"
      ]
    }
  }
}

Recharger et vérifier que les outils apparaissent

Redémarrez ou rechargez le client MCP. Le serveur copera doit se connecter et exposer ses outils (list_boards, search, search_docs, etc.). Si le client prend en charge la découverte d'outils, vous verrez le catalogue complet décrit dans la Référence des outils.

Faire votre premier appel

Demandez au modèle d'appeler get_workspace_info — un outil en lecture seule qui confirme que le token résout le bon workspace. Ensuite, list_boards → list_tables → list_rows suit le flux de découverte.

Connecteurs OAuth

Certains clients (comme Claude avec des connecteurs distants) peuvent se connecter via OAuth au lieu d'un token collé. Lorsque vous ajoutez l'URL du serveur sans bearer, le client reçoit un 401 avec un challenge WWW-Authenticate et démarre automatiquement le flux OAuth, créant un token cp_oat_…. Voir Authentification.

Tester avec le MCP Inspector

Le MCP Inspector est le moyen le plus rapide de confirmer la connectivité et d'explorer les outils à la main avant de brancher un agent.

Lancer l'Inspector

npx @modelcontextprotocol/inspector

Configurer la connexion

Dans l'interface de l'Inspector :

Transport type : Streamable HTTP
URL : https://mcp.copera.ai/mcp
Authentication : ajoutez un en-tête Authorization avec la valeur Bearer cp_pat_YOUR_TOKEN_HERE

Lister et appeler les outils

Connectez-vous, ouvrez l'onglet Tools, et vous devriez voir les 37 outils. Appelez get_workspace_info pour vérifier le token, puis essayez list_boards pour confirmer l'accès en lecture.

Gardez les tokens secrets

Quiconque détient votre bearer token peut agir en votre nom dans les limites de ses scopes. Ne versionnez pas de tokens dans le contrôle de source et ne les collez pas dans des configurations partagées. Faites tourner un token immédiatement s'il fuit.

Dépannage

Symptôme	Cause probable
`401 Unauthorized`	Bearer token manquant, mal formé ou expiré. Revérifiez l'en-tête `Authorization: Bearer …`.
`403 Forbidden` sur un outil	Le token n'a pas le scope requis par cet outil (p. ex. `access_docs` pour les outils documents). Voir Authentification.
`405 Method Not Allowed`	Le client a envoyé `GET`/`DELETE` à `/mcp`. Le serveur est sans état — utilisez `POST`.
Outils manquants dans le client	Le serveur s'est connecté mais le client a filtré les outils, ou le token résout un workspace sans ces données. Vérifiez avec l'Inspector.

Endpoint​

Connecter un client​

Tester avec le MCP Inspector​

Dépannage​

Endpoint

Connecter un client

Tester avec le MCP Inspector

Dépannage