apifirme
ro en de hu

apifirme az MI-asszisztensedben

A saját szavaiddal kérdezel, az asszisztens pedig a hivatalos nyilvántartásokban keresi meg a választ, és megmondja, honnan veszi. Működik a Claude-dal, a ChatGPT-vel, a Perplexityvel, a Mistrallal, a Grokkal, a Copilottal, a Cursorral és minden más asszisztenssel, amely beszéli a Model Context Protocolt (MCP).

Egyetlen cím

https://api.apifirme.dev/mcp
  1. Beilleszted a címet az asszisztensedbe, ott, ahol csatlakozót vagy MCP-szervert lehet hozzáadni.
  2. Az asszisztens az apifirméhez irányít: belépsz az e-mail-címeddel (vagy ott helyben, ingyen fiókot nyitsz), és megnyomod az „Engedélyezem” gombot.
  3. Kérdezel. Az asszisztens maga dönti el, mit kell megkeresnie.

Nem kell kulcsot másolnod, és semmit sem kell telepítened. Az ingyenes csomag havi 100 kérdésre elég; a csatlakoztatás nem számít bele.

Mit kérdezhetsz

Nem tudod a CUI-t? Az asszisztens név vagy cégjegyzékszám alapján megtalálja a céget.

Lépésről lépésre, az asszisztensedben

A menük az egyes asszisztensekéi, és időnként változnak. Ha nem találsz egy lehetőséget, keresd a beállításokban a „connector” vagy az „MCP” szót: a fenti címen kívül másra nincs szükséged.

Claude · claude.ai és Claude Desktop, bármely csomagban; az ingyenes egyetlen saját csatlakozót enged
  1. Nyisd meg a Customize → Connectors részt, kattints a „+” gombra, és válaszd az „Add custom connector” lehetőséget.
  2. Írj be egy nevet, például apifirme, és illeszd be a fenti címet.
  3. A többi beállítást hagyd úgy, ahogy van, kattints az „Add”, majd a „Connect” gombra.
  4. Az asszisztens az apifirméhez irányít: belépsz (vagy ott helyben, ingyen fiókot nyitsz), és megnyomod az „Engedélyezem” gombot.
ChatGPT · weben, fizetős csomaggal; a saját csatlakozók a „Developer mode” részei
  1. A Settings részben kapcsold be a „Developer mode”-ot.
  2. Adj hozzá egy új alkalmazást (chatgpt.com/plugins, „+” gomb): egy név, a fenti cím az „MCP server URL” mezőbe, hitelesítésnek pedig „OAuth”.
  3. Az asszisztens az apifirméhez irányít: belépsz (vagy ott helyben, ingyen fiókot nyitsz), és megnyomod az „Engedélyezem” gombot.
  4. Egy beszélgetésben válaszd az apifirmét a „+” menüből.
Perplexity · Pro, Max és Enterprise csomagok, weben és az asztali alkalmazásban
  1. Nyisd meg a Settings → Connectors részt, kattints a „+ Custom connector” gombra, és válaszd a „Remote” lehetőséget.
  2. Írj be egy nevet és a fenti címet; az „Authentication” mezőnél válaszd az „OAuth”, a „Transport” mezőnél a „Streamable HTTP” lehetőséget.
  3. Kattints a hozzáadott csatlakozóra a bejelentkezés elindításához.
  4. Az asszisztens az apifirméhez irányít: belépsz (vagy ott helyben, ingyen fiókot nyitsz), és megnyomod az „Engedélyezem” gombot.
Mistral (Le Chat, Vibe)
  1. Nyisd meg a Connectors részt, kattints a „+ Add Connector” gombra, és válaszd a „Custom MCP Connector” fület.
  2. Írj be egy nevet és a fenti címet, majd kattints a „Connect” gombra; a hitelesítés módját automatikusan felismeri.
  3. Az asszisztens az apifirméhez irányít: belépsz (vagy ott helyben, ingyen fiókot nyitsz), és megnyomod az „Engedélyezem” gombot.
Grok
  1. Nyisd meg a grok.com/connectors oldalt, kattints a „New Connector” gombra, és válaszd a „Custom” lehetőséget.
  2. Illeszd be a fenti címet, és indítsd el a bejelentkezést.
  3. Az asszisztens az apifirméhez irányít: belépsz (vagy ott helyben, ingyen fiókot nyitsz), és megnyomod az „Engedélyezem” gombot.
Microsoft Copilot Studio · a Copilot Studióban készített ügynökökhöz; a Microsoft 365 Copilotban a csatlakozókat a rendszergazda adja hozzá
  1. Az ügynökben: Tools → Add a tool → New tool → Model Context Protocol.
  2. Írj be egy nevet, egy leírást és a fenti címet; hitelesítésnek válaszd az „OAuth 2.0”-t „Dynamic discovery” módban.
  3. Az asszisztens az apifirméhez irányít: belépsz (vagy ott helyben, ingyen fiókot nyitsz), és megnyomod az „Engedélyezem” gombot.
Gemini
  1. A Gemini alkalmazás egyelőre csak az egyesült államokbeli személyes fiókoknál fogad saját MCP-szervert: Settings → Connected Apps → Custom apps → „Add a custom app”, a fenti címmel.
  2. Máshol használd a Gemini CLI-t: lásd lejjebb.

Programoknak és ügynököknek: API-kulccsal

A konfigurációs fájlt olvasó eszközök bejelentkezés helyett API-kulcsot is küldhetnek az Authorization fejlécben. A kulcsot a fiókodban hozod létre, és a YOUR_API_KEY helyére írod.

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

Ezután írd be a Claude Code-ban, hogy /mcp, és válaszd az apifirmét a bejelentkezéshez. Ha bejelentkezés helyett kulcsot használsz, fűzd a parancshoz: --header "Authorization: Bearer YOUR_API_KEY"

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

A „headers” sor nélkül a Cursor bejelentkezni küld, mint a fenti asszisztensek.

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}" }
    }
  }
}

A VS Code egyszer kéri el a kulcsot, és a fájlon kívül tárolja.

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"

A kulcs az APIFIRME_API_KEY környezeti változóban van.

Windsurf, Cline, Zed, LM Studio, Goose, n8n és mások 
{
  "mcpServers": {
    "apifirme": {
      "url": "https://api.apifirme.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

A cím mezőjét kliensenként másképp hívják: url, serverUrl (Windsurf), httpUrl (Gemini CLI), uri (Goose). Ahol átviteli módot kell megadni, válaszd a „Streamable HTTP”-t.

A saját kódodból: az OpenAI és az Anthropic API-jai 
// 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" }

Mit kap az asszisztens

Eszköz Mire való
find_company Cég keresése CUI nélkül: név vagy cégjegyzékszám szerint.
lookup_company Egy cég adatai CUI alapján: név, székhely, állapot, CAEN-kód, áfa, e-Factura.
check_invoice Számlázás előtti ellenőrzés: létezik, áfaalany, pénzforgalmi áfa, inaktív, e-Factura.
get_financials Az éves beszámolók 2008-tól.
get_company_events Mi változott egy cégnél, amióta követjük.
get_fx_rate A BNR referencia-árfolyama 2005-től.
count_new_companies Hány új céget jegyeztek be, tevékenységi kör és megye szerint. Minden csomagban.
list_new_companies Az újonnan bejegyzett cégek listája. Azokban a csomagokban, amelyek tartalmazzák.

Minden eszköz csak olvas. Az asszisztens semmit sem tud megváltoztatni, sem az adatokban, sem a fiókodban.

Jó tudni