Konvoi MCP-server

Vereisten

Koppelen

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

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

Scripts

Persoonlijke tokens: Profiel → AI-clients → Persoonlijk token aanmaken

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":{}}}'

Waar het bij kan

• Elke werkruimte die je kunt openen waar Dispatch en AI-clients aan staan, met je rol in die werkruimte.
• Bij het koppelen kun je het beperken tot enkele werkruimtes en Wijzigingen voorstellen weglaten.
• Een werkruimtebeheerder kan een koppeling uit zijn werkruimte verwijderen via Dispatch → Koppelen.
• Profiel → AI-clients toont je koppelingen; Ontkoppelen beëindigt er meteen een.

Tools

Leestools zoeken dingen op met jouw rol. propose_*-tools maken een voorstel en wijzigen zelf niets.De beschrijvingen van de tools zijn in het Engels, zoals de AI-client ze ziet.

Wijzigingen zijn voorstellen

• Een propose_*-tool wijzigt zelf niets. Hij maakt een voorstel in Konvoi Dispatch en geeft de link terug.
• Gewone voorstellen: goedkeuren of afwijzen in de client als die het je kan vragen, anders in Konvoi Dispatch.
• Voorstellen met Beheerder keurt goed: een werkruimtebeheerder keurt ze goed in Konvoi Dispatch.
• Een goedgekeurde wijziging loopt als de persoon die goedkeurt, met diens rol. Elke oproep en beslissing wordt gelogd.
• Voorstellen vraagt de toegang Wijzigingen voorstellen, gekozen bij het koppelen.

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

Limieten

Beveiliging

• Tokens zijn willekeurige tekenreeksen die alleen als hash worden bewaard. Toegangstokens gelden 1 uur; vernieuwingstokens wisselen bij elk gebruik en vervallen na 30 dagen ongebruikt; persoonlijke tokens gelden 30, 90 of 365 dagen.
• Al je koppelingen worden meteen ingetrokken als je je wachtwoord wijzigt, overal afmeldt of tweestapsverificatie uitzet.
• Een oud vernieuwingstoken opnieuw aanbieden trekt die koppeling in.
• Koppelingen volgen de sessievergrendeling niet. Een koppeling toestaan vraagt een volledig ontgrendelde sessie.
• Tekst van buiten Konvoi, zoals gescande documenten en e-mails, is gemarkeerd met {"untrusted": true}. Clients krijgen de opdracht die als gegevens te behandelen, nooit als instructies.
• Gegevens waarnaar je vraagt, gaan naar de client die je gebruikt.

Problemen oplossen