apifirme în asistentul tău AI

Întrebi în cuvintele tale, iar asistentul caută răspunsul în registrele oficiale și îți spune de unde îl are. Merge cu Claude, ChatGPT, Perplexity, Mistral, Grok, Copilot, Cursor și cu orice alt asistent care vorbește Model Context Protocol (MCP).

O singură adresă

https://api.apifirme.dev/mcp
  1. Lipești adresa în asistentul tău, acolo unde se adaugă un conector sau un server MCP.
  2. Asistentul te trimite la apifirme: intri în cont cu adresa ta de e-mail (sau îți faci unul pe loc, gratuit) și apeși „Permite”.
  3. Întrebi. Asistentul alege singur ce are de căutat.

Nu copiezi nicio cheie și nu instalezi nimic. Planul gratuit ajunge pentru 100 de întrebări pe lună; conectarea nu se numără.

Ce poți întreba

Nu știi CUI-ul? Asistentul găsește firma după denumire sau după numărul din registrul comerțului.

Pas cu pas, în asistentul tău

Meniurile sunt ale fiecărui asistent și se mai schimbă. Dacă nu găsești o opțiune, caută „connector” sau „MCP” în setările lui: adresa de mai sus este tot ce îți trebuie.

Claude · claude.ai și Claude Desktop, pe orice plan; cel gratuit permite un singur conector propriu
  1. Deschide Customize → Connectors, apasă „+” și alege „Add custom connector”.
  2. Scrie un nume, de exemplu apifirme, și lipește adresa de mai sus.
  3. Lasă celelalte opțiuni cum sunt și apasă „Add”, apoi „Connect”.
  4. Asistentul te trimite la apifirme: intri în cont (sau îți faci unul pe loc, gratuit) și apeși „Permite”.
ChatGPT · pe web, cu un plan plătit; conectorii proprii țin de „Developer mode”
  1. În Settings, activează „Developer mode”.
  2. Adaugă o aplicație nouă (chatgpt.com/plugins, butonul „+”): un nume, adresa de mai sus la „MCP server URL” și „OAuth” la autentificare.
  3. Asistentul te trimite la apifirme: intri în cont (sau îți faci unul pe loc, gratuit) și apeși „Permite”.
  4. Într-o conversație, alege apifirme din meniul „+”.
Perplexity · planurile Pro, Max și Enterprise, pe web și în aplicația de desktop
  1. Deschide Settings → Connectors, apasă „+ Custom connector” și alege „Remote”.
  2. Scrie un nume și adresa de mai sus; la „Authentication” alege „OAuth”, la „Transport” „Streamable HTTP”.
  3. Apasă pe conectorul adăugat ca să pornești autentificarea.
  4. Asistentul te trimite la apifirme: intri în cont (sau îți faci unul pe loc, gratuit) și apeși „Permite”.
Mistral (Le Chat, Vibe)
  1. Deschide Connectors, apasă „+ Add Connector” și alege fila „Custom MCP Connector”.
  2. Scrie un nume și adresa de mai sus și apasă „Connect”; felul autentificării este găsit automat.
  3. Asistentul te trimite la apifirme: intri în cont (sau îți faci unul pe loc, gratuit) și apeși „Permite”.
Grok
  1. Deschide grok.com/connectors, apasă „New Connector” și alege „Custom”.
  2. Lipește adresa de mai sus și pornește autentificarea.
  3. Asistentul te trimite la apifirme: intri în cont (sau îți faci unul pe loc, gratuit) și apeși „Permite”.
Microsoft Copilot Studio · pentru agenții făcuți în Copilot Studio; în Microsoft 365 Copilot conectorii îi adaugă administratorul
  1. În agent: Tools → Add a tool → New tool → Model Context Protocol.
  2. Scrie un nume, o descriere și adresa de mai sus; la autentificare alege „OAuth 2.0” cu „Dynamic discovery”.
  3. Asistentul te trimite la apifirme: intri în cont (sau îți faci unul pe loc, gratuit) și apeși „Permite”.
Gemini
  1. Aplicația Gemini primește deocamdată servere MCP proprii doar pentru conturile personale din Statele Unite: Settings → Connected Apps → Custom apps → „Add a custom app”, cu adresa de mai sus.
  2. Oriunde altundeva, folosește Gemini CLI: vezi mai jos.

Pentru programe și agenți: cu o cheie API

Uneltele care citesc un fișier de configurare pot trimite, în loc de autentificare, o cheie API în antetul Authorization. Cheia o creezi în cont și o pui în locul lui YOUR_API_KEY.

Claude Code
claude mcp add --transport http apifirme https://api.apifirme.dev/mcp

Apoi scrie /mcp în Claude Code și alege apifirme ca să te autentifici. Cu o cheie în loc de autentificare, adaugă la comandă: --header "Authorization: Bearer YOUR_API_KEY"

Cursor · ~/.cursor/mcp.json
{
  "mcpServers": {
    "apifirme": {
      "url": "https://api.apifirme.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Fără rândul „headers”, Cursor te trimite să te autentifici, ca un asistent de mai sus.

VS Code (GitHub Copilot) · .vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "apifirme-key",
      "description": "apifirme API key",
      "password": true
    }
  ],
  "servers": {
    "apifirme": {
      "type": "http",
      "url": "https://api.apifirme.dev/mcp",
      "headers": { "Authorization": "Bearer ${input:apifirme-key}" }
    }
  }
}

VS Code îți cere cheia o dată și o păstrează în afara fișierului.

Gemini CLI
gemini mcp add --transport http --header "Authorization: Bearer YOUR_API_KEY" apifirme https://api.apifirme.dev/mcp
Codex CLI · ~/.codex/config.toml
[mcp_servers.apifirme]
url = "https://api.apifirme.dev/mcp"
bearer_token_env_var = "APIFIRME_API_KEY"

Cheia stă în variabila de mediu APIFIRME_API_KEY.

Windsurf, Cline, Zed, LM Studio, Goose, n8n și alții
{
  "mcpServers": {
    "apifirme": {
      "url": "https://api.apifirme.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Câmpul adresei are alt nume de la un client la altul: url, serverUrl (Windsurf), httpUrl (Gemini CLI), uri (Goose). Unde se cere un transport, alege „Streamable HTTP”.

Din codul tău: API-urile OpenAI și Anthropic
// OpenAI Responses API, in "tools"
{ "type": "mcp", "server_label": "apifirme", "server_url": "https://api.apifirme.dev/mcp",
  "headers": { "Authorization": "Bearer YOUR_API_KEY" }, "require_approval": "never" }

// Anthropic Messages API, in "mcp_servers"
{ "type": "url", "name": "apifirme", "url": "https://api.apifirme.dev/mcp",
  "authorization_token": "YOUR_API_KEY" }

Ce primește asistentul

Unealta La ce folosește
find_company Găsește o firmă fără CUI: după denumire sau după numărul din registrul comerțului.
lookup_company Datele unei firme după CUI: denumire, sediu, stare, CAEN, TVA, e-Factura.
check_invoice Verificarea dinaintea facturării: există, plătitoare de TVA, TVA la încasare, inactivă, e-Factura.
get_financials Situațiile financiare anuale, din 2008.
get_company_events Ce s-a schimbat la o firmă de când o urmărim.
get_fx_rate Cursul de referință BNR, din 2005.
count_new_companies Câte firme noi s-au înregistrat, pe domeniu și județ. În orice plan.
list_new_companies Lista firmelor nou înregistrate. În planurile care o includ.

Toate uneltele doar citesc. Asistentul nu poate schimba nimic, nici în date, nici în contul tău.

Bine de știut