apifirme în asistentul tău AI

Întrebi în cuvintele tale; asistentul caută în registrele oficiale și îți spune de unde are răspunsul. Merge cu Claude, ChatGPT, Perplexity, Mistral, Grok, Copilot, Cursor și 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ă.

Contul îl poți face și înainte. Dacă ești deja în cont în același browser, la pasul al doilea doar apeși „Permite”.

fă-ți un cont gratuit

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 diferă de la un asistent la altul și se mai schimbă. Dacă nu găsești o opțiune, caută „connector” sau „MCP” în setări: 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
  1. Deschide chatgpt.com/plugins, apasă „+” și alege „Add custom MCP server”. Dacă opțiunea lipsește, activează întâi „Developer mode” în Settings → Apps → Advanced settings.
  2. Scrie un nume, de exemplu apifirme, și o descriere; la conectare lipește adresa de mai sus, iar la autentificare alege „OAuth”.
  3. Confirmă cu „I understand and want to continue”, apoi apasă „Create as a plugin”.
  4. Asistentul te trimite la apifirme: intri în cont (sau îți faci unul pe loc, gratuit) și apeși „Permite”.
  5. Într-o conversație nouă, scrie @ și alege apifirme.
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 planul Plus și în cele mai mari, de la 69 lei + TVA pe lună.

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

Bine de știut