Serveur MCP Konvoi

Prérequis

Connexion

claude mcp add --transport http konvoi https://konvoi.ai/api/mcp

{
  "mcpServers": {
    "konvoi": {
      "url": "https://konvoi.ai/api/mcp"
    }
  }
}

Scripts

Jetons personnels : Profile → AI clients → Create personal token

curl -s https://konvoi.ai/api/mcp \
  -H "Authorization: Bearer $KONVOI_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "curl",
      "version": "1.0"
    }
  }
}'

curl -s https://konvoi.ai/api/mcp \
  -H "Authorization: Bearer $KONVOI_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

curl -s https://konvoi.ai/api/mcp \
  -H "Authorization: Bearer $KONVOI_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_workspaces","arguments":{}}}'

Ce qui est accessible

• Chaque espace de travail auquel vous avez accès et où Dispatch et les clients IA sont activés, avec votre rôle dans cet espace de travail.
• Lors de la connexion, vous pouvez la limiter à certains espaces de travail et exclure « Propose changes ».
• Un administrateur d’espace de travail peut retirer une connexion de son espace de travail dans Dispatch → Connect.
• Profile → AI clients liste vos connexions ; Disconnect met fin à l’une d’elles immédiatement.

Outils

Les outils de lecture consultent les données avec votre rôle. Les outils propose_* créent une proposition et ne modifient rien eux-mêmes.

Les modifications sont des propositions

• Un outil propose_* ne modifie rien lui-même. Il crée une proposition dans Konvoi Dispatch et renvoie son lien.
• Propositions courantes : approuvez-les ou rejetez-les dans le client quand il peut vous le demander, sinon dans Konvoi Dispatch.
• Propositions marquées « Approbation admin » : un administrateur de l’espace de travail les approuve dans Konvoi Dispatch.
• Une modification approuvée s’exécute au nom de la personne qui l’approuve, avec son rôle. Chaque appel et chaque décision sont journalisés.
• Proposer nécessite l’accès « Propose changes », choisi lors de la connexion.

Prompts

Handle this week’s fines

Match each open fine to a driver, propose assignments, flag contest candidates.

fine-triage

Sweep fuel for anomalies

Impossible fills vs tank size, off-hours fills at the depot, duplicate charges.

fuel-anomaly

What expires in the next 30 days

Technical inspections, insurance, registrations and licenses coming due.

expiry-sweep

Weekly fleet review

Utilization, idle vehicles, telemetry highlights — one digest.

weekly-telemetry

Limites

Sécurité

• Les jetons sont des chaînes aléatoires stockées uniquement sous forme de hash. Les jetons d’accès durent 1 heure ; les jetons de rafraîchissement changent à chaque utilisation et expirent après 30 jours sans utilisation ; les jetons personnels durent 30, 90 ou 365 jours.
• Toutes vos connexions sont révoquées d’un coup lorsque vous changez votre mot de passe, vous déconnectez partout ou désactivez l’authentification à deux facteurs.
• Présenter à nouveau un ancien jeton de rafraîchissement révoque cette connexion.
• Les connexions ne suivent pas le verrouillage de session. Autoriser une connexion nécessite une session entièrement déverrouillée.
• Le texte provenant de l’extérieur de Konvoi, comme les documents scannés et les e-mails, est marqué {"untrusted": true}. Les clients ont pour consigne de le traiter comme des données, jamais comme des instructions.
• Les données sur lesquelles vous posez des questions sont envoyées au client que vous utilisez.

Dépannage