Taxora MCP

Lokális Claude MCP connector a Taxora üzleti rendszerhez. Stdio alapú – nincs szerver, nincs adatbázis.

Telepítés

cd "C:\Users\ThinkPad\Desktop\Taxora MCP"
npm install
npm run build

Beállítás Claude Desktop config-ban

A Claude Desktop konfigurációs fájl helye:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add hozzá ezt a blokkot:

{
  "mcpServers": {
    "taxora": {
      "command": "node",
      "args": ["C:\\Users\\ThinkPad\\Desktop\\Taxora MCP\\dist\\index.js"]
    }
  }
}

API kulcs megadása (2 lehetőség)

A) Env var a config-ban (ajánlott – nincs külön setup lépés):

{
  "mcpServers": {
    "taxora": {
      "command": "node",
      "args": ["C:\\Users\\ThinkPad\\Desktop\\Taxora MCP\\dist\\index.js"],
      "env": {
        "TAXORA_API_KEY": "usr_XXXXXXXXXXXXX"
      }
    }
  }
}

B) Dinamikus setup tool-lal (első indítás után a chatben):

Miután hozzáadtad a config-hoz és újraindítottad Claude Desktop-ot, írd be a chatben:

Hívd meg a taxora_setup tool-t

A connector visszaadja a lépéseket, majd beilleszted a kulcsot. Ezután a kulcs itt tárolódik: ~/.taxora-mcp/config.json

API kulcs generálása

1. Menj ide: https://connectai.scgsmart.hu/dashboard/settings/api-keys
2. Kattints az "Új kulcs generálása" gombra
3. Másold ki az usr_... formátumú kulcsot – csak egyszer látható!

Elérhető toolok (40+)

| Csoport | Toolok | |---------|--------| | Setup | taxora_setup, taxora_delete_key | | Profil | taxora_get_profile, taxora_get_settings, taxora_get_sync_state, taxora_get_api_keys | | Partnerek | taxora_get_partners, taxora_get_partner_bank_accounts, taxora_get_partner_locations | | Számlák | taxora_get_invoices, taxora_get_invoice_attachments, taxora_get_invoice_allocation_links, taxora_get_invoice_project_links | | Projektek | taxora_get_projects, taxora_get_project_tasks, taxora_get_task_statuses, taxora_get_grant_projects | | Munkavállalók | taxora_get_employees, taxora_get_payroll, taxora_get_timesheets, taxora_get_employee_allocations | | Pénzügyek | taxora_get_bank_transactions, taxora_get_cash_transactions, taxora_get_cash_registers, taxora_get_allocations | | Eszközök | taxora_get_assets, taxora_get_asset_categories, taxora_get_asset_usage_logs | | Dokumentumok | taxora_get_documents, taxora_get_document_folders, taxora_get_document_types | | Aktivitás | taxora_get_activities, taxora_get_knowledge | | Botok | taxora_get_bots, taxora_get_bot_conversations, taxora_get_bot_messages, taxora_get_bot_reports | | Külső | taxora_get_external_entities, taxora_get_external_sync_logs, taxora_get_external_webhook_events |

Lokális kulcstároló

Ha a taxora_setup tool-lal adod meg a kulcsot, itt lesz elmentve:

• Windows: C:\Users\<felhasználó>\.taxora-mcp\config.json
• macOS/Linux: ~/.taxora-mcp/config.json

Az env var (TAXORA_API_KEY) mindig felülírja a fájlban tárolt kulcsot.