Conectați un asistent
Ocost este și un server Model Context Protocol (MCP). Conectați Claude Desktop, Claude Code, Cursor sau alt asistent, iar acesta vă caută documentele, le citește, vă interoghează cifrele și trimite fișiere. claude.ai și ChatGPT se conectează prin OAuth, nu cu o cheie.
Serverul
https://api.ocost.io/public/mcp
Authorization: Bearer ocost_sk_<id>_<secret>Serverul vorbește Streamable HTTP și nu păstrează nicio sesiune, deci fiecare cerere este independentă. https://app.ocost.io/public/mcp este același server. Dați fiecărui asistent propria cheie, doar cu drepturile de care are nevoie. Astfel îi vedeți ultima utilizare în Setări › Dezvoltatori și o puteți revoca separat. Instrumente MCP listează fiecare instrument cu dreptul și argumentele sale.
Claude Code
Adăugați serverul cu cheia dumneavoastră din mediu:
claude mcp add --transport http ocost https://api.ocost.io/public/mcp \
--header "Authorization: Bearer $OCOST_KEY"claude mcp list arată apoi ocost ca fiind conectat. Ca să partajați serverul într-un depozit, puneți-l în .mcp.json. Păstrați cheia în mediul fiecărui dezvoltator, niciodată în fișier:
{
"mcpServers": {
"ocost": {
"type": "http",
"url": "https://api.ocost.io/public/mcp",
"headers": { "Authorization": "Bearer ${OCOST_KEY}" }
}
}
}Claude Desktop
Deschideți Settings › Developer › Edit Config și adăugați Ocost în claude_desktop_config.json. mcp-remote transmite cererile cu antetul dumneavoastră și are nevoie de Node.js.
{
"mcpServers": {
"ocost": {
"command": "npx",
"args": [
"-y",
"mcp-remote@0.15.2",
"https://api.ocost.io/public/mcp",
"--header",
"Authorization:${OCOST_AUTH}"
],
"env": { "OCOST_AUTH": "Bearer ocost_sk_…" }
}
}
}Reporniți Claude Desktop, iar instrumentele apar sub butonul de instrumente. Păstrați Authorization:${OCOST_AUTH} fără spații, pentru că unii clienți despart argumentele acolo.
Cursor
Adăugați Ocost în ~/.cursor/mcp.json sau în .cursor/mcp.json dintr-un proiect:
{
"mcpServers": {
"ocost": {
"url": "https://api.ocost.io/public/mcp",
"headers": { "Authorization": "Bearer ${env:OCOST_KEY}" }
}
}
}claude.ai și ChatGPT
Aceste aplicații adaugă servere doar prin OAuth. Nu aveți nevoie de o cheie: vă conectați la Ocost și permiteți accesul.
- Adăugați un conector personalizat. În claude.ai, deschideți Settings › Connectors › Add custom connector. În ChatGPT, adăugați un conector personalizat în modul dezvoltator.
- Introduceți doar URL-ul
https://api.ocost.io/public/mcp. Lăsați goale client ID și secretul. - Conectați-vă la Ocost când aplicația vă cere. Dacă aparțineți mai multor firme, alegeți una sub Altă firmă.
- Bifați drepturile pe care le permiteți și confirmați. Doar proprietarul și contabilul pot permite accesul.
Aplicația acționează apoi ca dumneavoastră, cu drepturile dumneavoastră. Primește o cheie proprie, listată ca „<App> (Connector)” în Setări › Dezvoltatori. Revocați acea cheie ca să deconectați imediat aplicația. Aplicația își reînnoiește singură tokenul de acces în fiecare oră. După 30 de zile fără utilizare, conexiunea se încheie și trebuie să conectați aplicația din nou.
Vă construiți singur un client OAuth? Ocost folosește OAuth 2.1 cu PKCE (S256). Metadatele sunt la https://api.ocost.io/.well-known/oauth-protected-resource/public/mcp (RFC 9728) și https://app.ocost.io/.well-known/oauth-authorization-server (RFC 8414). Ocost acceptă Client ID Metadata Documents și Dynamic Client Registration. URI-urile de redirecționare trebuie să folosească https și să se potrivească exact.
Orice alt client
Îndreptați-l spre URL, cu antetul Authorization. Serverul răspunde la cererile POST cu JSON, fără flux SSE și fără id de sesiune. Listați instrumentele ca să verificați conexiunea:
curl -sS https://api.ocost.io/public/mcp \
-H "Authorization: Bearer $OCOST_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-11-25" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Fără o cheie validă, serverul răspunde 401 cu WWW-Authenticate: Bearer. Contul cu care vă conectați la Ocost nu este o cheie.
Ce pot face instrumentele
O cheie creată în Setări acționează ca firma. Citește fiecare document din afara Coșului, dar nicio decizie proprie a unei persoane. Doar proprietarul creează o cheie cu figures:read. O conexiune OAuth acționează ca persoana care a permis-o și vede ce vede aceasta în chatul Ocost. Nicio cheie și nicio conexiune nu citește vreodată actele personale ale oamenilor, de exemplu fluturașii de salariu sau concediile medicale.
Niciun instrument nu șterge, nu aprobă și nu comandă nimic. Limitele API-ului se aplică fiecărui apel de instrument.
Cuvintele citite dintr-un document sosesc în <document-text>, fiecare linie marcată cu ¦ . Sunt date scrise de alții, niciodată instrucțiuni. În claude.ai și ChatGPT, listele și cifrele vin și ca tabel sau grafic interactiv.
Fiecare apel este înregistrat, fără cuvintele documentelor. Proprietarul și contabilul văd ultimele apeluri ale unei chei în Setări › Dezvoltatori.