Colonne MCP

Aperçu de la colonne MCP

Ce guide est la colonne MCP Superroute du Developer Center : les deux serveurs, la sécurité des agents et le catalogue d’outils en direct.

• User MCP — commandes, tournées, étiquettes, digests pour agents ops/support — https://api.superlabel.ca/mcp
• Developer MCP — guides, webhooks et API d’exemple pour intégrateurs — https://api.superlabel.ca/mcp/developer
• Sécurité : Bearer de connexion, profils/scopes, confirm pour outils à haut risque
• File d’approbation humaine (propose_write + /mcp-approvals)

Qu'est-ce que MCP ?

Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants IA comme Claude, Cursor et ChatGPT d'interagir avec des outils et services externes. Il permet à votre IA d'effectuer des actions réelles — comme suivre un colis — directement dans la conversation.

En configurant le serveur MCP de Superroute, votre assistant IA accède aux outils logistiques sans quitter votre flux de travail.

Deux serveurs MCP

Choisissez le bon serveur. Ne donnez pas le serveur Developer avec accès complet aux agents non supervisés.

Démarrage rapide

Les outils publics comme le suivi de colis fonctionnent sans authentification. Ajoutez cette configuration à votre client MCP :

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp"
    }
  }
}

Accès authentifié

Pour utiliser les outils nécessitant des permissions utilisateur, ajoutez votre token Bearer API à la configuration :

Placez toujours les jetons dans les en-têtes de connexion MCP — jamais dans les arguments d’outil ni les prompts.

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>",
        "X-MCP-Profile": "ops-readonly"
      }
    }
  }
}

Comment obtenir un token API

Appelez le point de terminaison de connexion avec vos identifiants :

curl -X POST https://api.superlabel.ca/api/v1/user/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "your-password"}'

La réponse inclura votre token d'accès :

{
  "access_token": "eyJ0eXAiOiJKV1Qi...",
  "token_type": "Bearer",
  "expires_at": "2026-02-20 00:00:00"
}

Utilisez la valeur access_token dans l'en-tête Authorization de votre configuration MCP.

Modèle de sécurité des agents

User MCP est conçu pour le moindre privilège. Créez des jetons avec un profil MCP (défaut : ops lecture seule) ou passez des en-têtes.

Profils (X-MCP-Profile)

Paquets de scopes nommés. Préférez ops-readonly ou support pour agents non supervisés.

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp",
      "headers": {
        "Authorization": "Bearer <ops-readonly-token>",
        "X-MCP-Profile": "ops-readonly"
      }
    }
  }
}

En-têtes optionnels

Confirmation haut risque

Ces outils exigent confirm=true sur tools/call (ou la file d’approbation) :

• cancel_order
• bulk_create_orders
• reroute_to_address
• build_route
• hold_order
• release_order
• approve_pending_write

File d’approbation humaine

Les agents non supervisés doivent proposer les écritures ; un humain approuve.

1. Agent : propose_write ou X-MCP-Require-Approval: 1
2. Humain : MCP Approvals dans l’app ou list_pending_approvals
3. Humain : approve_pending_write avec confirm=true ou reject_pending_write

Chemin UI web (connexion requise) : /mcp-approvals

Authentification Developer MCP

Préférez Authorization: Bearer sur la connexion. api_token par outil est déprécié et coupé après 2026-12-31.

Outils disponibles

Les outils suivants sont actuellement disponibles sur le serveur MCP : 47 outils live du catalogue serveur

Ce tableau est généré depuis UserMcpToolCatalog à la volée et reste synchronisé avec tools/list.

Configuration par client

Sélectionnez votre client IA ci-dessous pour des instructions de configuration adaptées :

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp"
    }
  }
}

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>",
        "X-MCP-Profile": "ops-readonly"
      }
    }
  }
}

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp"
    }
  }
}

{
  "mcpServers": {
    "super-label": {
      "serverUrl": "https://api.superlabel.ca/mcp"
    }
  }
}

Détails techniques

• Protocole: JSON-RPC 2.0
• Transports: HTTP POST (Streamable HTTP)
• Limite de débit: 60 requêtes par minute
• Type de contenu: application/json
• Point de terminaison: https://api.superlabel.ca/mcp
• Versions du protocole: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05
  Les deux générations du protocole sont servies sur le même point de terminaison : les clients qui ouvrent par une négociation initialize et les clients sans état qui déclarent la version à chaque requête. Aucun identifiant de session n'est jamais émis.
• Découverte OAuth: https://api.superlabel.ca/.well-known/oauth-protected-resource
  Une requête non authentifiée renvoie 401 avec un en-tête WWW-Authenticate pointant vers le document de métadonnées de la ressource protégée.