bokio-mcp

bokio-mcp

Bokio 会計 API 用の MCP サーバーです。Claude やほかの MCP クライアントに接続すれば、帳簿について自然な言葉で質問できます。指定日の銀行口座残高、未払いの顧客請求書、前四半期の VAT の合計、二重計上の有無などを尋ねられます。

Bokio で自社の帳簿を管理している小規模企業やコンサルタント向けに構築されています。デフォルトでは読み取り専用で、書き込みツールは有効にするまで非表示のため、実際の会計データを安心して参照できます。

対応内容

このサーバーは、1 社分の Bokio API をラップします。仕訳、請求書、クレジットノート、顧客、サプライヤー、仕入先請求書、品目、アップロード、銀行支払い（読み取り専用）、勘定科目表、会計年度、SIE エクスポートに対応しています。

また、SIE エクスポートを使って動作する計算ツールも備えています。指定日時点の残高、特定の勘定科目の元帳、期間ごとの VAT と損益、未決済項目、二重計上の可能性、銀行明細との照合に対応しています。サーバーは öre 単位で計算し、結果をクライアントに渡すため、同じ質問には毎回同じ回答が返されます。

はじめる前に

次の 3 つが必要です。

1. Bokio のプライベート統合トークン。Bokio で Integrations に移動し、統合を作成してトークンをコピーします。Bokio では、1 社あたり月 5,000 件、毎分 200 件のリクエストが許可されています。
2. 会社 ID。Bokio の URL に含まれています：.../companies/<companyId>/...。
3. Node.js 22 以降。

インストール

サーバーはクローンせずに npm から直接実行できます。stdio 経由で MCP と通信するため、MCP クライアントがサーバーを起動します。サーバーの MCP Registry での名前は io.github.diblaze/bokio-mcp です。

AI エージェントをお使いですか？ https://raw.githubusercontent.com/diblaze/bokio-mcp/main/LLM.md を貼り付けて、bokio-mcp のインストールを依頼してください。

Claude Code

claude mcp add --transport stdio --scope user \
  --env BOKIO_TOKEN=your_token \
  --env BOKIO_COMPANY_ID=your_company_id \
  bokio -- npx -y bokio-mcp

Claude Desktop およびその他の MCP クライアント

クライアントの mcpServers 設定に次の内容を追加します（Claude Desktop の場合は claude_desktop_config.json）。

{
  "mcpServers": {
    "bokio": {
      "command": "npx",
      "args": ["-y", "bokio-mcp"],
      "env": {
        "BOKIO_TOKEN": "your_token",
        "BOKIO_COMPANY_ID": "your_company_id",
        "BOKIO_DOWNLOAD_DIR": "/path/for/downloads",
        "BOKIO_ALLOW_WRITES": ""
      }
    }
  }
}

コミットまたは共有するファイルにトークンを含めないでください。Claude Code など、環境変数に対応しているクライアントでは、シェル環境から ${BOKIO_TOKEN} を読み込めます。

設定

変数	必須	用途
BOKIO_TOKEN	ツール呼び出し時に必要	プライベート Bearer トークン
BOKIO_COMPANY_ID	デフォルトの会社	ツール呼び出しで companyId が省略された場合に使用
BOKIO_ALLOW_WRITES	いいえ	1、true、yes、on のいずれかで書き込みツールを有効化します。それ以外の場合は非表示となり、ブロックされます
BOKIO_DOWNLOAD_DIR	推奨	SIE、PDF、アップロードのダウンロード先。設定しない場合、ダウンロードはサーバーの作業ディレクトリに保存されます。その場所が / の場合は拒否されます。これは Claude Desktop ではよくある設定です。指定ディレクトリ外のパスは拒否され、既存ファイルが上書きされることはありません
BOKIO_BASE_URL	いいえ	デフォルトは https://api.bokio.se/v1

読み取りと書き込み

Bokio でデータを作成または変更する場合は BOKIO_ALLOW_WRITES=1 を設定し、それ以外のときは空欄にしてください。書き込みツールには、以下で (write) と表示されています。

銀行支払いは意図的に読み取り専用です。BankID で署名すると送金が実行されるため、サーバーでは銀行支払いを作成できません。

ツール

会社と元帳： bokio_company_info、bokio_list_fiscal_years、bokio_get_fiscal_year、bokio_chart_of_accounts、bokio_get_account、bokio_download_sie

仕訳： bokio_list_journal_entries（from/to/query）、bokio_get_journal_entry、bokio_create_journal_entry (書き込み)、bokio_reverse_journal_entry (書き込み)

請求書： bokio_list_invoices、bokio_get_invoice、bokio_create_invoice (書き込み)、bokio_update_invoice (書き込み)、bokio_delete_invoice (書き込み)、bokio_publish_invoice (書き込み)、bokio_record_invoice (書き込み)、bokio_create_invoice_payment (書き込み)、bokio_download_invoice（PDF）、bokio_list_invoice_payments、bokio_list_invoice_settlements、bokio_create_invoice_settlement (書き込み)

クレジットノート： bokio_list_credit_notes、bokio_get_credit_note、bokio_download_credit_note（PDF）、bokio_create_credit_note (書き込み、請求書から作成)、bokio_update_credit_note (書き込み)、bokio_publish_credit_note (書き込み)、bokio_record_credit_note (書き込み)、bokio_delete_credit_note (書き込み、下書きのみ)

仕入先： bokio_list_suppliers、bokio_get_supplier、bokio_create_supplier (書き込み)、bokio_update_supplier (書き込み)

仕入先請求書： bokio_list_supplier_invoices、bokio_get_supplier_invoice、bokio_create_supplier_invoice (書き込み)、bokio_update_supplier_invoice (書き込み)

顧客： bokio_list_customers、bokio_get_customer、bokio_create_customer (書き込み)、bokio_update_customer (書き込み)

品目： bokio_list_items、bokio_get_item、bokio_create_item (書き込み)、bokio_update_item (書き込み)

アップロード： bokio_list_uploads、bokio_get_upload、bokio_upload_file (書き込み)、bokio_download_upload

銀行支払い： bokio_list_bank_payments、bokio_get_bank_payment。Bokio が返すのは、同じインテグレーションによって作成された支払いのみです。

計算済みデータ： bokio_account_balances、bokio_account_ledger、bokio_find_duplicates、bokio_reconcile_bank（銀行明細を{date, amount, text}形式の行として渡します）、bokio_vat_summary（勘定科目の合計であり、VAT申告書の欄にはマッピングされません）、bokio_profit_and_loss、bokio_open_items（請求書モジュールを介さず、手動の仕訳として売上を記帳した場合にも機能します）。各呼び出しでは、必要な会計年度のSIEエクスポートをダウンロードします（1年につき1リクエスト）。金額は元帳上の符号で、借方が正、貸方が負です。また、検証の金額はAnnullering av …による取消仕訳と相殺されます。

その他： bokio_raw_getは、任意のBokioパスにGETリクエストを送信します。

制限事項

• 仕訳は複式簿記のため、借方合計と貸方合計は一致する必要があります。
• タググループ、プロジェクト、仕訳コメントとタグ、請求書の添付ファイルには、まだ対応するツールがありません。bokio_raw_getで読み取ってください。
• BokioのAPIリファレンスはhttps://docs.bokio.se、OpenAPI仕様はhttps://github.com/bokio/bokio-apiで確認できます。

コントリビューション

Issueやプルリクエストを歓迎します。CONTRIBUTING.mdでは、ソースからのビルド、テストとスモークチェックの実行方法、プルリクエストに必要な内容について説明しています。要約すると、コミットはConventional Commitsに従います。pnpm installを実行すると、フォーマットとコミットメッセージをチェックするGitフックが設定されます。また、メンテナーによるレビューの前に、Node 22と24でCIが成功する必要があります。ツールの追加には、同じファイルに専用のチェックリストがあります。

セキュリティ上の問題は、公開Issueではなく、SECURITY.mdの説明に従って非公開で報告してください。リリースノートはCHANGELOG.mdにあります。

ライセンス

MIT