# 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
```

- Lipești adresa în asistentul tău, acolo unde se adaugă un conector sau un server MCP.
- 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”.
- Î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

- Pot emite o factură cu TVA către firma cu CUI 13548146?
- Ce CUI are Cubus Arts din Sibiu și mai este în funcțiune?
- Ce cifră de afaceri și ce profit a avut RO13548146 în ultimii cinci ani?
- S-a schimbat ceva la firma asta în ultima vreme? Mai este în funcțiune?
- Câte firme de software s-au înființat luna aceasta în Cluj și în Sibiu?
- Cât a fost cursul BNR pentru euro la 15 martie 2024?

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)

- Deschide Customize → Connectors, apasă „+” și alege „Add custom connector”.
- Scrie un nume, de exemplu apifirme, și lipește adresa de mai sus.
- Lasă celelalte opțiuni cum sunt și apasă „Add”, apoi „Connect”.
- 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”)

- În Settings, activează „Developer mode”.
- Adaugă o aplicație nouă (chatgpt.com/plugins, butonul „+”): un nume, adresa de mai sus la „MCP server URL” și „OAuth” la autentificare.
- Asistentul te trimite la apifirme: intri în cont (sau îți faci unul pe loc, gratuit) și apeși „Permite”.
- Într-o conversație, alege apifirme din meniul „+”.

### Perplexity (planurile Pro, Max și Enterprise, pe web și în aplicația de desktop)

- Deschide Settings → Connectors, apasă „+ Custom connector” și alege „Remote”.
- Scrie un nume și adresa de mai sus; la „Authentication” alege „OAuth”, la „Transport” „Streamable HTTP”.
- Apasă pe conectorul adăugat ca să pornești autentificarea.
- Asistentul te trimite la apifirme: intri în cont (sau îți faci unul pe loc, gratuit) și apeși „Permite”.

### Mistral (Le Chat, Vibe)

- Deschide Connectors, apasă „+ Add Connector” și alege fila „Custom MCP Connector”.
- Scrie un nume și adresa de mai sus și apasă „Connect”; felul autentificării este găsit automat.
- Asistentul te trimite la apifirme: intri în cont (sau îți faci unul pe loc, gratuit) și apeși „Permite”.

### Grok

- Deschide grok.com/connectors, apasă „New Connector” și alege „Custom”.
- Lipește adresa de mai sus și pornește autentificarea.
- 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)

- În agent: Tools → Add a tool → New tool → Model Context Protocol.
- Scrie un nume, o descriere și adresa de mai sus; la autentificare alege „OAuth 2.0” cu „Dynamic discovery”.
- Asistentul te trimite la apifirme: intri în cont (sau îți faci unul pe loc, gratuit) și apeși „Permite”.

### Gemini

- 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.
- 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 se creează în cont și se pune î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

- Se numără doar întrebările puse registrelor (apelurile de unelte), fiecare ca o cerere din planul tău. Conectarea și lista de unelte nu se numără.
- Un asistent conectat apare în cont ca o cheie care îi poartă numele. Îl deconectezi revocând cheia.
- Fiecare răspuns vine cu sursa și data informației. Cere-i asistentului să ți le spună.
- Despre persoane fizice (PFA, întreprinderi individuale și familiale) nu se servesc date.
- Tehnic: transport Streamable HTTP, protocolul MCP în revizia 2026-07-28 și în cele din 2025, autentificare OAuth 2.1 sau cheie API.