Qurak

MCP-server

Koble Claude, Cursor, VS Code eller enhver MCP-klient til Qurak-motoren.

Hva tilkoblingen gir assistenten din

En assistent som gjetter på aritmetikk, tar feil akkurat ofte nok til at det betyr noe. Koblet til her overlater den matematikken til en ekte motor og returnerer et utregnet svar i stedet for et sannsynlig et — analyse, differensiallikninger, algebra, statistikk, plott.

Tilkoblingen forteller agenten din sannheten om seg selv før noe beregningstid er brukt: check_support svarer på om en funksjon finnes, get_capabilities rapporterer grensene som faktisk gjelder, og plan_computation gjør et mål om til en fungerende metode med verifiserte oppskrifter vedlagt. En agent fortsetter å kalle et verktøy som på forhånd sier hva det ikke kan.

Den er åpen på alle planer, også gratisplanen, og hele tilkoblingen er én URL. Det en betalt plan kjøper, er beregningsbudsjett og rate — aldri tilgangen.

Opprett et token   Logg inn

Endepunkter

URLTransportBruk
https://qurak.com/mcpStreamable HTTPForetrukket. Bruk denne med mindre klienten din ikke kan.
https://qurak.com/mcp/sseHTTP+SSE (2024-11-05)Utfaset, kun for eldre klienter.

Transporten er tilstandsløs: den utsteder ingen protokoll-økt-id, så GET og DELETE/mcp svarer 405 med vilje. Det er atskilt fra den valgfrie session_id som de evaluerende verktøyene tar — se Verktøy — som er et verktøyargument du velger, ikke noe transporten deler ut.

To måter å logge inn på

De fleste klienter håndterer dette for deg. Velg klienten din nedenfor og følg den ene veien den viser — du trenger ikke begge.

MetodeSlik virker detBruk det når
OAuthKlienten åpner nettleseren din, du logger inn på Qurak og godkjenner forespørselen. Ingen legitimasjon kopieres noen gang for hånd.Klienten din spør bare etter en URL — Claude Desktop og claude.ai har ikke noe sted å legge et token.
Bearer-tokenDu oppretter et token og legger det i en Authorization -header i klientens konfigurasjon.Klienten din støtter headere og du vil ha en fast legitimasjon — nyttig for CI eller en delt maskin.

Hva OAuth ber om

ScopeGir
qurak:evaluateKjøre uttrykk og lage plott på kontoen din. Bruker planens beregningsbudsjett og ratebegrensning.
qurak:docsLese funksjonsreferansen. Bruker ingen beregningstid, så en tilkobling kun for dokumentasjon er trygg å gi bredt.

Under panseret er dette en standard OAuth 2.1-flyt med PKCE, som kan oppdages på /.well-known/oauth-protected-resource og /.well-known/oauth-authorization-server (besvares også under /.well-known/openid-configuration, som noen klienter prøver først). En klient kan identifisere seg på tre måter — et klient-ID-metadatadokument, dynamisk registrering, eller en klient-ID og hemmelighet du registrerer nedenfor — og klienter som støtter en av dem, finner det på egen hånd.

Klientoppsett

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

<code>type</code> er påkrevd. En oppføring med en <code>url</code> og uten <code>type</code> leses som en stdio-server og hoppes stille over.

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

Utelat <code>--header</code>-flagget for å bruke OAuth i stedet: Claude Code åpner en nettleser ved første tilkobling.

  1. Åpne Innstillinger, deretter Koblinger.
  2. Velg Legg til egendefinert kobling.
  3. Lim inn <code>https://qurak.com/mcp</code> og bekreft.
  4. Et nettleservindu åpnes. Logg inn på Qurak og godkjenn forespørselen.

Denne veien er nødvendigvis kun OAuth — det finnes ikke noe felt for et token. De samme stegene gjelder claude.ai-koblinger.

  1. Åpne Innstillinger, deretter MCP.
  2. Legg til en server med URL-en <code>https://qurak.com/mcp</code>.
  3. Godkjenn nettleserforespørselen.

Cursor foretrekker OAuth så snart en server publiserer discovery-metadata, noe denne gjør — så en <code>headers</code>-blokk i konfigurasjonen dens blir trolig ignorert. Forvent nettleserflyten, og la den gå.

Nøkkelen er <code>servers</code>, ikke <code>mcpServers</code>.

.vscode/mcp.json
{
  "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 }
  ]
}

Å bruke <code>inputs</code> holder tokenet ute av filen, så konfigurasjonen er trygg å committe.

Hvis klienten din bare snakker den eldre HTTP+SSE-transporten, pek den mot <code>https://qurak.com/mcp/sse</code> i stedet.

URL
https://qurak.com/mcp

Verktøy

VerktøyHva det gjørScope
evaluateEvaluer et Qurak-uttrykk (.wl-kompatibel syntaks). Returnerer det formaterte resultatet, med tiden det tok. Valgfri session_id, format (Standard, TeX, JSON) og timeout_ms.qurak:evaluate
plotKjør et plotteuttrykk og returner diagrammet som et PNG-bilde. Tar de samme session_id og timeout_ms.qurak:evaluate
clear_sessionForkast en evalueringsøkt og alt som er definert i den.qurak:evaluate
search_docsSøk i funksjonsreferansen etter navn eller beskrivelse, og i oppgaveoppskriftene ved siden av. Valgfri kind (function, task, any); hvert resultat sier hvilket det er.qurak:docs
get_taskÉn oppgaveoppskrift i sin helhet: stegene i rekkefølge, og utdataene hvert av dem ga da det ble verifisert mot denne motoren. Stegene kjøres etter hverandre i én økt.qurak:docs
get_symbolAlt som er kjent om ett symbol: tilgjengelighet, former, alternativer, eksempler.qurak:docs
check_supportSjekk om bestemte funksjoner er tilgjengelige, før du bruker dem.qurak:docs
plan_computationForankrer et mål før utregningen: dommer om støtte for hver funksjon i et uttrykksutkast, de nærmeste verifiserte oppskriftene, og en rutinganbefaling i denne tilkoblingens egne budsjett-tall. Bruker ingen beregningstid.qurak:docs
evaluate_asyncSender inn et uttrykk som bakgrunnsjobb med et planavhengig budsjett på flere minutter, for arbeid det interaktive budsjettet ikke rommer. Returnerer en jobb-id med én gang; jobber er en daglig kvote.qurak:evaluate
get_job
list_jobs
cancel_job
En jobbs status og, når den er ferdig, hele resultatet (send wait_ms, så long-poller ett kall i stedet for titalls stramme kall); de siste jobbene på kontoen; avbrytelse. Polling er gratis.qurak:evaluate
simulate_circuitSimulerer en kvantekrets - ideell tilstandsvektor, standard portsett - og returnerer målehistogrammet. Kjører som bakgrunnsjobb, med et kubittak som følger planen.qurak:evaluate
save_guide
get_guide
list_guides
delete_guide
Varige notater på kontoen: lagre en arbeidsmodells definisjoner og antakelser under et navn, og les dem tilbake i en senere samtale. Lesing krever docs-scopet; skriving krever evaluate.qurak:docs
qurak:evaluate
get_capabilitiesGrensene som gjelder for denne tilkoblingen, som tall: tak på beregningsbudsjettet, kvote per minutt og hva som gjenstår av den, største lagrede plott, gitte scoper, øktgrenser. Ingen argumenter.alle
WolframLanguageEvaluatorEldre alias for evaluate, beholdt for klienter som forventer AgentTools-verktøynavnet. Samme argumenter, samme oppførsel.qurak:evaluate

Beholde tilstand mellom kall

evaluate og plot er tilstandsløse med mindre du sender en session_id. Med en beholdes definisjoner — a = 10 i ett kall, deretter a + 5 i det neste med samme id, evalueres til 15. Økter er private for kontoen din, så to kontoer som bruker samme id, ser aldri hverandres variabler. De forkastes etter 30 minutters inaktivitet, når en evaluering i dem får tidsavbrudd (motoren kan ikke avbrytes, så økten ryker med), eller når du kaller clear_session.

Grenser og feil

Beregningsbudsjett og ratebegrensning følger planen din — se Abonnementer, eller kall get_capabilities fra selve tilkoblingen for tallene som gjelder. Å overskride en av dem kommer tilbake som et verktøyresultat med isError satt, ikke en transportfeil, slik at agenten din kan lese meldingen og tilpasse seg. Det samme gjelder en syntaksfeil, et tidsavbrudd eller en feil inne i motoren: de er svar, og tilkoblingen forblir åpen.

check_support forteller deg hva som er tilgjengelig uten å bruke en evaluering. timeout_ms lar et kall be om et kortere budsjett enn planen tillater — nyttig for å feile raskt på et uttrykk du forventer er billig. Det begrenses til planens eget budsjett, så det kan ikke kjøpe mer tid enn du har. Fil-, prosess- og nettverksfunksjoner er blokkert.