MCP 経由で QuickBooks Online を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → QuickBooks Online をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

QuickBooks Online + Cursor

AI に QuickBooks Online で作業させます。顧客、仕入先、商品とサービス、請求書、仕入請求書、入金、勘定科目の照会、個別レコードの読み取り、損益計算書、貸借対照表、売掛金と買掛金の年齢表のレポート実行、顧客と請求書の作成ができます。Intuit の OAuth でサインインし、サンドボックスと本番の会社に対応しています。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

QBO_CLIENT_ID, QBO_CLIENT_SECRET, QBO_REALM_ID, QBO_API_URL

ステップ 1 — 認証情報を取得

1. developer.intuit.com にサインインし、My Hub → App dashboard → Create an app を開いて QuickBooks Online and Payments を選び、スコープ com.intuit.quickbooks.accounting を選択します。
2. Settings → Redirect URIs で、Development 用に、そして後で Production 用にも https://cloud.anythingmcp.com/api/mcp-oauth/callback を追加します。AnythingMCP をセルフホストしている場合は、代わりに https://your-anythingmcp-host/api/mcp-oauth/callback を入力します。URI は完全に一致している必要があります。
3. Keys & credentials にある Client ID と Client Secret を、QBO_CLIENT_ID と QBO_CLIENT_SECRET にコピーします。Development のキーはサンドボックスの会社でしか使えません。Production のキーは実際の会社で使えます。Production のキーは、簡単なアプリ審査（アプリダッシュボード上のアンケート）を経て Intuit から付与されます。
4. 会社の realm id（Company ID）を確認します。QuickBooks で歯車アイコンをクリックし、Account and settings → Billing & subscription を開いて、Company ID をスペースなしでコピーします。サンドボックスの会社の場合は、開発者サイトの Sandboxes で確認できます。これを QBO_REALM_ID に貼り付けます。
5. QBO_API_URL には、実際の会社なら https://quickbooks.api.intuit.com を、サンドボックスの会社なら https://sandbox-quickbooks.api.intuit.com を設定します。この URL はキーと一致させる必要があります。Development のキーにはサンドボックスの URL、Production のキーには本番の URL を使います。
6. コネクターをインストールし、コネクターのページで Authorize with Provider をクリックして Intuit にサインインし、同じ会社を接続します。
7. まず qbo_get_company_info を実行し、AI が何かを読み書きする前に会社名を確認します。1 つのコネクターで扱えるのは 1 つの会社だけです。2 つ目の会社には、コネクターをもう一度インストールしてください。

サインイン状態の維持: アクセストークンの有効期間は 1 時間で、自動的に更新されます。100 日間使われなかったリフレッシュトークンは失効し、どの承認も最長 5 年で終了します。そうなった場合や、QuickBooks でアプリの接続が解除された場合は、もう一度 Authorize with Provider をクリックしてください。同じ Intuit アプリを別のツールで同時に使わないでください。Intuit はリフレッシュトークンをおよそ 1 日に 1 回置き換えるため、どちらか一方に古いトークンが残ってしまいます。

権限と読み取り専用の設定: スコープ com.intuit.quickbooks.accounting は、サインインする QuickBooks ユーザーのロールが許す範囲で、会計データへの読み取りと書き込みのアクセス権を与えます。Intuit には読み取り専用の会計スコープがありません。読み取り専用にするには、取引を作成できないロールのユーザーでサインインし、qbo_create_customer、qbo_update_customer、qbo_create_invoice を無効にします。

インストール時はオフ: 会社の名前で顧客に請求書をメール送信する qbo_send_invoice と、qbo_delete_invoice。AI に請求書を送信または削除させる場合だけオンにしてください。

請求書はすぐに記帳されます: QuickBooks には下書きの請求書がありません。AI が作成した請求書は、すぐに顧客の残高を増やし、レポートにも表示されますが、メールで送信はされません。顧客は削除できず、無効にすることしかできません。

顧客名: 顧客の表示名は、顧客、仕入先、従業員の全体で一意である必要があり、コロン（QuickBooks はサブ顧客の区切りにコロンを使います）、タブ、改行を含めることはできません。

よくあるエラー: 401 AuthenticationFailed（3200）は、承認の期限が切れたか取り消されたこと、または QBO_API_URL がキーと一致していないことを示します。URL を確認してから、もう一度 Authorize with Provider をクリックしてください。403 ApplicationAuthorizationFailed（3100）は、realm id がこのサインインで許可されていない会社のものであるか、ユーザーのロールにアクセス権がないことを示します。400 QueryParserError は、クエリの構文エラーを示します。6240 Duplicate Name Exists Error は表示名がすでに使われていること、2040 Invalid String は名前にコロン、タブ、改行のいずれかが含まれていること、5010 Stale Object Error はその間にレコードが変更されたため読み直す必要があることを示します。429 は 1 分あたり 500 リクエストの上限に達したことを示します。1 分待ってください。

このコネクターは、請求書の PDF と添付ファイル、入金の記録、銀行フィード、給与計算、QuickBooks Desktop は扱わず、請求書以外は何も削除しません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが QuickBooks Online のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「支払期限を過ぎた請求書はどれ？顧客ごとの未払い額も教えて。」
• 「今年度の損益計算書を月別に見せて。」
• 「Acme Ltd 宛てに請求書を作成して。「コンサルティング」サービス 10 時間分、支払期限は 30 日後で。」
• 「支払期限を 60 日以上過ぎている仕入先の請求書はどれ？」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Gemini に接続
• Meta Muse に接続