Serverul MCP: spațiul tău de lucru, din instrumentele tale

Documentele firmei, memoria și tabelele de date se află în spațiul de lucru Agentique. Tu lucrezi într-un terminal, într-un editor sau într-un agent pe care ți-l construiești singur. Serverul MCP le leagă: un singur endpoint HTTP care expune instrumentele spațiului de lucru către orice client care vorbește Model Context Protocol.

MCP este un standard deschis, iar Agentique îl implementează ca un endpoint JSON-RPC 2.0 obișnuit, peste transportul Streamable HTTP. Nu ai de instalat niciun SDK și nu favorizăm niciun client: o aplicație AI de desktop, un plugin de IDE, un script din cron, un serviciu intern, orice program care poate trimite un POST HTTP cu un header poate folosi spațiul de lucru. Serverul vorbește versiunile de protocol de la 2024-11-05 până la 2025-06-18, deci negociază curat și cu clienți mai vechi, și cu cei actuali.

Ce expune endpointul

Treizeci și unu de instrumente, alese cu grijă. Căutare și regăsire (intelligent_search, keyword_search, list_documents, get_document), memoria spațiului de lucru (search_memory, save_memory), tabelele de date doar în citire (list_entity_types, search_entity_records), acces web doar în citire (web_search, fetch_webpage), calcul pur (calculate, convert_units), Google Sheets și Drive dacă spațiul tău de lucru are Google conectat, starea și sincronizarea SPV e-Factura (spv_status, spv_trigger_sync), licitații publice (seap_search, seap_market, tender_list, tender_show, tender_analyze, tender_decide, company_file, tender_dossier, tender_dossier_build), plus generarea de rapoarte de constatări (create_findings_report).

La fel de deliberat este ce lipsește. Nimic distructiv nu e accesibil cu o cheie API: fără ștergere, fără trimis emailuri, fără cereri arbitrare către exterior (instrumentele web fac doar căutare și citire). Acțiunile de acest fel rămân în interfața spațiului de lucru, unde un om le confirmă pe fiecare. O cheie scursă nu trebuie să poată vreodată să scrie clienților tăi sau să golească un dosar, așa că suprafața e construită ca și cum orice cheie s-ar scurge într-o zi.

Aceasta este poziția implicită, nu un plafon definitiv. Dacă integrarea ta chiar are nevoie de una dintre acțiunile excluse, spune-ne: preferăm să extindem suprafața deliberat, cu aceleași limite de siguranță, decât să livrăm tuturor niște setări implicite periculoase.

Conectare în doi pași

Tot ce îți trebuie este în Setări, în panoul serverului MCP: URL-ul exact al endpointului spațiului tău de lucru și cheile API. Un administrator al spațiului de lucru creează o cheie cu nume și drepturi, iar cheia în clar (un token ak_) se afișează exact o singură dată, la creare. Se stochează doar un hash, deci copiaz-o atunci. Cheile pot fi revocate oricând, pot avea dată de expirare și arată când au fost folosite ultima oară.

Întâi, verifică legătura cu curl:

curl -s https://endpoint-ul-workspace-ului/api/v1/mcp/ \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ak_cheia_ta" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Primești înapoi toate cele treizeci și unu de instrumente, cu schemele lor JSON. Un GET simplu pe același URL întoarce informații despre server, deci verificările de stare sunt banale.

Apoi îndreaptă-ți clientul spre el. Clienții care vorbesc Streamable HTTP folosesc o configurare de forma aceasta. Claude Code o citește din .mcp.json la rădăcina proiectului, iar Cursor acceptă aceeași pereche url plus headers în .cursor/mcp.json:

{
  "mcpServers": {
    "agentique": {
      "type": "http",
      "url": "https://endpoint-ul-workspace-ului/api/v1/mcp/",
      "headers": { "X-API-Key": "ak_cheia_ta" }
    }
  }
}

Unii clienți vorbesc doar stdio. Pentru ei există un bridge: un script Python într-un singur fișier, doar bibliotecă standard, Python 3.10+, descărcabil din același panou din Setări. Citește JSON-RPC de pe stdin și îl trimite mai departe către endpointul tău, prin HTTPS. Claude Desktop e exemplul obișnuit:

{
  "mcpServers": {
    "agentique": {
      "command": "python3",
      "args": ["/cale/absoluta/catre/agentique-mcp-bridge.py"],
      "env": {
        "AGENTIQUE_URL": "https://endpoint-ul-workspace-ului/api/v1/mcp/",
        "AGENTIQUE_API_KEY": "ak_cheia_ta"
      }
    }
  }
}

Drepturi și limite, la vedere

Fiecare cheie aparține unui singur spațiu de lucru și nu poate vedea decât datele acestuia. Drepturile limitează cheia exact la sarcina ei: read acoperă căutarea, documentele, citirea memoriei, interogarea tabelelor și consultarea licitațiilor; write adaugă salvarea în memorie, scrierile în Sheets/Drive, declanșarea sincronizării SPV și trei instrumente pentru licitații (tender_analyze, tender_decide, tender_dossier_build); instrumentele de calcul nu cer niciun drept; admin deschide tot și rareori este ce vrei. tender_decide înregistrează o decizie doar când o spune utilizatorul, niciodată din proprie inițiativă. Limitele sunt 60 de cereri pe minut per cheie și 15 pe minut pentru instrumentele costisitoare (căutarea semantică, instrumentele web, importul din Drive, generarea de rapoarte). Răspunsurile sunt JSON sincron, fără SSE: cererea se încheie când se încheie instrumentul.

Trei lucruri care merită construite

Întrebi spațiul de lucru fără să ieși din editor. „Ce termene de plată am agreat cu furnizorul ăsta?”, cu răspunsul direct în IDE, însoțit de documentul-sursă și de pagină, în timp ce scrii codul care depinde de el. Aceleași răspunsuri pe care le dă spațiul de lucru, în instrumentele pe care le folosești deja; aici am explicat cum funcționează răspunsurile.

Un script de reconciliere. O sarcină programată în fiecare noapte trage înregistrările dintr-un tabel de date, le compară cu sistemul tău intern și scrie diferențele într-un Google Sheet pe care echipa îl urmărește oricum. Drept de citire pentru interogare, drept de scriere pentru foaie, douăzeci de linii de cod.

Agentul tău, cu context real. Construiești un agent în orice cadru de dezvoltare compatibil cu MCP? Un singur bloc de configurare îi dă documentele și memoria firmei ca instrumente, cu toate limitele de mai sus impuse pe server, nu promise în client.