MCP 経由で Xero を Gemini に接続する方法

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

Xero + Gemini

AI に Xero の会計データを読ませます。売上請求書と仕入請求書、顧客と仕入先の連絡先、勘定科目表、試算表（Trial Balance）、期間比較付きの損益計算書を、発生主義または現金主義で参照できます。読み取り専用で、自分の Xero OAuth2 アプリを使い、Authorize with Provider でサインインします。

前提条件

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

XERO_CLIENT_ID, XERO_CLIENT_SECRET

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

1. developer.xero.com/app/manage（My Apps）にサインインし、タイプ Web app の OAuth2 アプリを作成します（認可コードフロー）。
2. リダイレクト URI には、AnythingMCP Cloud なら https://cloud.anythingmcp.com/api/mcp-oauth/callback を、AnythingMCP をセルフホストしている場合は <あなたの AnythingMCP の URL>/api/mcp-oauth/callback を入力します。URI は完全に一致している必要があります。
3. アプリの Configuration ページで Client ID を XERO_CLIENT_ID にコピーし、client secret を生成して XERO_CLIENT_SECRET に貼り付けます。
4. XERO_TENANT_ID と XERO_REFRESH_TOKEN は空のまま、コネクターをインストールします。コネクターのページで Authorize with Provider をクリックし、Xero にサインインして、AI に読ませる組織を接続します。
5. xero_list_connections を実行します。正しい tenantName を持ち、tenantType が ORGANISATION のエントリーを選び、その tenantId を XERO_TENANT_ID にコピーします。接続の id や authEventId は別の値なので使わないでください。XERO_TENANT_ID が未設定のあいだ、ほかのツールは Xero を呼び出す前に停止し、不足している変数名を示します。
6. xero_get_organisation を実行し、AI が数値を読む前に組織名を確認します。1 つのコネクターで読めるのは 1 つの組織だけです。2 つ目の組織には、コネクターをもう一度インストールしてください。

サインイン状態の維持: アクセストークンの有効期間は 30 分で、自動的に更新されます。AnythingMCP は Xero が発行する新しいリフレッシュトークンを毎回保存します。60 日間更新されなかったリフレッシュトークンは失効するので、その場合はもう一度 Authorize with Provider をクリックしてください。XERO_REFRESH_TOKEN は、同じアプリで同じ読み取り専用の同意を得た有効なリフレッシュトークンをすでに持っている場合にだけ入力します。リフレッシュトークンをほかの連携と共有しないでください。Xero は更新のたびにトークンを置き換えるため、どちらか一方に無効なトークンが残ってしまいます。

最初から読み取り専用: 10 個のツールはすべて読み取りのみ（GET）で、会計データの作成、変更、削除は行いません。コネクターが要求するのは読み取り専用のスコープ openid offline_access accounting.invoices.read accounting.contacts.read accounting.settings.read accounting.reports.trialbalance.read accounting.reports.profitandloss.read です。Xero の同意は置き換えではなく追加されます。以前にこのアプリへ書き込みのスコープを許可していた場合、トークンはその権限を保持したままです。権限を絞るには、Xero で古い接続を取り消してから、もう一度 Authorize with Provider をクリックします。また、AI が見られるのは、サインインした Xero ユーザーが見られる範囲だけです。レポートを読むには、そのユーザーにレポートへのアクセス権が必要です。

請求書、連絡先、勘定科目: xero_list_invoices は売上請求書（ACCREC）と仕入請求書（ACCPAY）をまとめて返します。where で絞り込み（例: Type=="ACCREC"）、order で並べ替えます（例: InvoiceNumber ASC）。請求書と連絡先は 1 ページ最大 100 件で返され、AI はページが空になるか件数が満たなくなるまで次のページを取得します。xero_list_contacts は名前、連絡先番号、メールアドレスを検索し、指定すればアーカイブ済みの連絡先も含めます。勘定科目表は一度にすべて返されます。xero_get_invoice、xero_get_contact、xero_get_account には、対応する一覧で返された UUID が必要です。請求書番号、連絡先名、勘定科目コードでは取得できません。

レポート: xero_get_trial_balance は date を 1 つ、xero_get_profit_and_loss は fromDate と toDate を受け取ります（形式は YYYY-MM-DD）。どちらも、現金主義（paymentsOnly）を指定しない限り発生主義で集計されます。損益計算書では、月、四半期、年の単位で 1 から 12 期間を比較できます（periods と timeframe）。

よくあるエラー: 401 または 403 は、同意がない、承認の期限が切れた、Xero ユーザーに必要な権限がない、または組織がこのアプリに接続されていないことを示します。XERO_TENANT_ID を xero_list_connections の結果と照らし合わせてから、もう一度 Authorize with Provider をクリックしてください。429 は、その組織に対する Xero のレート制限に達したことを示します。AI は Retry-After で示された秒数だけ待ってから再試行し、どの制限に達したかは X-Rate-Limit-Problem ヘッダーでわかります。制限はアプリのティアによって異なります。詳しくは Xero の API 制限 を参照してください。

このコネクターは Xero で何も作成、変更、削除せず、銀行取引、貸借対照表、給与、ファイルや添付ファイルも読み取りません。

ステップ 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 — Gemini にコネクタを追加

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

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Xero のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「まだ入金されていない売上請求書はどれ？顧客ごとの未収額の合計も教えて。」
• 「前四半期の損益計算書を、その前の 3 四半期と比較して見せて。」
• 「今後 14 日以内に支払期限が来る仕入請求書はどれ？それぞれの金額も教えて。」
• 「連絡先から Acme Ltd を探して、メールアドレス、請求先住所、未払い残高を見せて。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

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