MCP-server

Wat verbinden je assistent oplevert

Een assistent die rekenwerk gokt, zit nét vaak genoeg fout om ertoe te doen. Hier verbonden geeft hij de wiskunde aan een echte engine en komt hij terug met een berekend antwoord in plaats van een plausibel antwoord — analyse, differentiaalvergelijkingen, algebra, statistiek, plots.

De verbinding vertelt je agent de waarheid over zichzelf voordat er rekentijd wordt besteed: check_support beantwoordt of een functie bestaat, get_capabilities rapporteert de limieten die werkelijk gelden, en plan_computation maakt van een doel een werkende methode met geverifieerde recepten erbij. Een agent blijft een tool aanroepen dat vooraf zegt wat het niet kan.

Het staat open op elk abonnement, ook het gratis, en de hele verbinding is één URL. Wat een betaald abonnement koopt is rekenbudget en een hogere limiet — nooit de toegang.

Een token aanmaken   Inloggen

Endpoints

Het transport is stateless: het geeft geen protocol-sessie-id uit, dus GET en DELETE op /mcp antwoorden 405 — bewust zo. Dat staat los van de optionele session_id die de evaluerende tools aannemen — zie Tools — dat is een toolargument dat jij kiest, niet iets dat het transport uitdeelt.

Twee manieren om in te loggen

De meeste clients regelen dit voor je. Kies hieronder je client en volg het ene pad dat hij toont — je hebt niet beide nodig.

Waar OAuth om vraagt

Onder de motorkap is dit een standaard OAuth 2.1-flow met PKCE, vindbaar op /.well-known/oauth-protected-resource en /.well-known/oauth-authorization-server (ook beantwoord onder /.well-known/openid-configuration, dat sommige clients eerst proberen). Een client kan zich op drie manieren identificeren — een client-ID-metadatadocument, dynamische registratie, of een client-ID en secret die je hieronder registreert — en clients die een ervan ondersteunen vinden het vanzelf.

Client-setup

claude mcp add --transport http qurak https://qurak.com/mcp \
  --header "Authorization: Bearer qk_..."

{
  "mcpServers": {
    "qurak": {
      "type": "http",
      "url": "https://qurak.com/mcp",
      "headers": { "Authorization": "Bearer qk_..." }
    }
  }
}

{
  "servers": {
    "qurak": {
      "type": "http",
      "url": "https://qurak.com/mcp",
      "headers": { "Authorization": "Bearer ${input:qurak-token}" }
    }
  },
  "inputs": [
    { "id": "qurak-token", "type": "promptString",
      "description": "Qurak Bearer token", "password": true }
  ]
}

https://qurak.com/mcp

Tools

Status bewaren tussen aanroepen

evaluate en plot zijn stateless tenzij je een session_idmeegeeft. Met een sessie blijven definities behouden — a = 10 in één aanroep, dan a + 5 in de volgende met dezelfde id, evalueert tot 15. Sessies zijn privé voor je account, dus twee accounts met dezelfde id zien nooit elkaars variabelen. Ze worden weggegooid na 30 minuten inactiviteit, wanneer een evaluatie erin een time-out krijgt (de engine is niet te onderbreken, dus de sessie gaat mee), of wanneer je dit aanroept: clear_session.

Limieten en fouten

Rekenbudget en ratelimiet volgen je abonnement — zie Abonnementen, of roep get_capabilities aan vanuit de verbinding zelf voor de geldende cijfers. Het overschrijden van een van beide komt terug als toolresultaat met isError gezet, niet als transportfout, zodat je agent het bericht kan lezen en zich kan aanpassen. Hetzelfde geldt voor een syntaxfout, een time-out of een fout in de engine: het zijn antwoorden, en de verbinding blijft open.

check_support vertelt je wat beschikbaar is zonder een evaluatie te besteden. timeout_ms laat een aanroep om een korter budget vragen dan het abonnement toestaat — handig om snel te falen op een expressie die je goedkoop verwacht. Het wordt begrensd op het budget van het abonnement zelf, dus het kan geen extra tijd kopen. Bestands-, proces- en netwerkfuncties zijn geblokkeerd.