Aikount Mcp

Aikount MCP — Claude、Cursor、ChatGPT 向けの AI 搭載スペイン会計

スペインの自営業者や中小企業向け会計 MCP サーバーです。 会計業務をあらゆる AI エージェントで行えます。請求書の発行、経費 PDF の OCR 取り込み、銀行取引の照合、Modelo 303 の準備まで、Claude、Cursor、ChatGPT、またはあらゆる MCP クライアントから実行できます。

Aikount はエージェントファーストの会計 SaaSです。会計業務をAI が担うことを想定した、Holded の代替サービスです。このリポジトリは、公開 REST API を通じて AI エージェントを帳簿に接続する、公式の MCP（Model Context Protocol）サーバーです。Aikount では、API が製品であり、ウェブインターフェースは人間向けの予備手段です。

スペインで AI エージェントに会計を任せたい自営業者または会計事務所の方ですか？ aikount.com から始めて、この MCP サーバーでエージェントを接続してください。

何ができますか？（ツール）

ツール	機能
whoami	トークンを検証し、アクティブなテナント（会社）を返します
list_contacts / create_contact	顧客と仕入先
list_tax_types	明細行用の IVA/IGIC/IPSI/IRPF 税区分と UUID
list_products	商品・サービスのカタログ
list_invoices / get_invoice	売上請求書を確認します
create_invoice / issue_invoice	下書きを作成して発行します（正式な番号を割り当てます）
list_purchases / get_purchase	経費・仕入請求書を確認します
ingest_purchase_pdf / get_ingest_job	PDF を OCR で経費に取り込みます。重複は発生しません
list_treasuries	残高付きの銀行／Stripe／PayPal 口座
list_bank_movements	銀行取引。絞り込みに対応
reconciliation_board / reconcile_movement	銀行取引の自動照合
list_accounts / ledger / trial_balance	スペイン一般会計科目表（PGC）、総勘定元帳、試算表
modelo_303_summary / modelo_303_csv	四半期ごとの IVA（Modelo 303）
api_request	その他すべてのエンドポイントにアクセスします（OpenAPI を参照）

なぜ create_purchase がないのですか？ 仕入請求書が重複すると、経費の合計、仕入 IVA、銀行照合が正しくなくなります。そのため、経費は請求書の識別情報で重複を排除する ingest_purchase_pdf 経由でのみ追加できます。

インストール

Aikount の API キー（scope *、接頭辞 agl_）が必要です。Aikount のウェブアプリ内にある **「エージェントを接続」**ボタンから生成できます。正確な export 行が表示されます。

オプション A — ホステッド版。インストール不要（リモート MCP）

ヘッダーにトークンを設定して、クライアントをホステッドエンドポイントに接続します。

URL:    https://api.aikount.com/mcp        (streamable-HTTP)
Header: Authorization: Bearer agl_tu_token

マルチテナント対応です。各リクエストはそれぞれのトークンで認証されます。リモート MCP に対応したクライアントに最適です。ローカル版と同じツールを利用できます。

オプション B — ローカル（このパッケージ）

export AIKOUNT_TOKEN="agl_xxxxxxxxxxxxxxxxxxxxxxxx"
# opcional, por defecto producción:
# export AIKOUNT_API="https://api.aikount.com/api/v1"

uv で実行します（インストール不要）。

uvx aikount-mcp@latest

または pip/pipx を使用します。

pipx install aikount-mcp   # o: pip install aikount-mcp
aikount-mcp

Claude Desktop / Claude Code

MCP の設定（claude_desktop_config.json、または Claude Code の .mcp.json）に追加します。

{
  "mcpServers": {
    "aikount": {
      "command": "uvx",
      "args": ["aikount-mcp@latest"],
      "env": { "AIKOUNT_TOKEN": "agl_xxxxxxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

Cursor

設定 → MCP → Add new server で、同じ command / args / env を指定します。

ユースケース

• 「5月分のコンサルティング料金として、ACMEに1,200 €の請求書を発行して。」 エージェントが 連絡先を検索し、VATを処理して下書きを作成します。あなたが確認して発行します。
• 「このAmazon Web ServicesのPDFを経費として登録して。」 OCR＋重複を排除した スペイン標準会計プランでの経費登録。
• 「第2四半期のVATはどうなっていますか？」 Modelo 303の概要をすぐに表示します。
• 「銀行の取引明細を請求書と照合して。」 自動銀行照合 （信頼度が0.95以上の場合は自動照合します）。

規約

• 金額はユーロの小数表記（unit_price: 1200.00）で、セント単位ではありません。currencyで別の通貨が指定されていない限り、EURです。
• 日付はISO-8601形式のAAAA-MM-DDです。IDはUUIDです。
• 明細では、テキストコードではなくtax_type_id（list_tax_typesのUUID）で税を指定します。連絡先／商品から継承する場合は省略してください。
• エラーは{"error": true, "status_code": ..., "detail": ..., "hint": ...}として返され、モデルが自己修正できるようになっています（401の場合は再認証、422の場合は本文を修正）。
• トークンのスコープは*です。パスワードとして扱ってください。会社ごとの分離（マルチテナント）は自動的に行われます。

このサーバーがラップしていない機能については、OpenAPI仕様が正式な情報源です。api_request経由でアクセスしてください。

よくある質問（FAQ）

Aikount MCPとは何ですか？

Claude、Cursor、ChatGPTなどのAIエージェントをAikountの会計に接続するMCP（Model Context Protocol）サーバーです。AIを使って、スペイン標準会計プランに基づく請求書の発行、経費の記録、銀行照合、税務申告の準備（Modelo 303）ができます。

Claude（またはCursor／ChatGPT）を会計に接続するにはどうすればよいですか？

uvx aikount-mcp@latestでサーバーをインストールし、Aikountで「エージェントを接続」を使ってAPIキーを生成してから、クライアントの設定にmcpServersブロックを追加します。数秒で、エージェントが帳簿の読み書きをできるようになります。

安全ですか？ Aikountは銀行の認証情報を保存しますか？

いいえ。銀行接続には規制対象のPSD2ゲートウェイ（Ponto Connect、Salt Edge、GoCardless）を使用します。Aikountが銀行の認証情報を保存することは決してありません。データはEU内でホストされます。APIトークンは取り消し可能で、会社ごとに分離されています。

スペインの自営業者や中小企業にも使えますか？

はい。Aikountはスペインの自営業者と中小企業、およびそれらを監督する会計事務所向けに設計されており、複数企業・複数通貨への対応、スペイン標準会計プラン、Veri*Factuを備えています。会計担当者に代わるものではなく、確認して署名できるよう、作業を済ませた状態で引き渡します。

Modelo 303とは何ですか？ AIで準備できますか？

Modelo 303は、スペインの四半期ごとのVAT自己申告書です。エージェントは、確認・提出用の四半期別概要（modelo_303_summary）と取引別の明細（modelo_303_csv）を作成します。

Holdedの代わりになりますか？

はい。Holdedがモジュール型のスイートであるのに対し、Aikountは会計業務を担うことに特化したAIエージェントで、請求額に応じた料金体系です。比較はこちら： aikount.com/alternativas-a-holded。

Aikountについて

Aikount — 自営業者、中小企業、会計事務所向けのエージェントファーストなスペイン会計サービスです。リソース：

• 🌐 Webサイト：aikount.com
• 🤖 AI会計：aikount.com/contabilidad-con-ia
• 🏦 自動銀行照合：aikount.com/conciliacion-bancaria-automatica
• 🧮 四半期VAT計算ツール（Modelo 303）：aikount.com/calculadora-iva-trimestral
• 🆚 Holdedの代替：aikount.com/alternativas-a-holded
• 📚 APIドキュメント：api.aikount.com/docs
• 🧩 エージェント向けコンテキスト：aikount.com/llms.txt

開発

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest -q          # 23 tests, sin red (httpx MockTransport)

テストでは、各ツールをライブの OpenAPI 仕様に照らして検証された API の実際のルートに固定し、ルートが気づかないうちに壊れるのを防ぎます。

server.json は、公式 MCP レジストリに登録するための、このパッケージのマニフェストです。

ライセンス

MIT — LICENSE をご覧ください。