Xero Billing and AR MCPサーバー

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

Xero Billing and AR MCPサーバーを使用すると、LLMは自然な会話を通じて、売掛金ライフサイクル全体にわたってXeroとやり取りできます。 接続済みのすべてのXero組織で、請求書と顧客の検索と確認、請求書の作成と管理、クレジットノートの発行、定期請求の設定を行うツールを提供し、Xeroインターフェイスを直接操作する必要はありません。

用途

Xero Billing and AR MCPサーバーを使用して、次のアクションを実行します:

  • 延滞残高を含め、自然な説明で販売請求書と顧客連絡先を検索および確認します。
  • 明細項目、勘定科目コード、税率を含む販売請求書をドラフトとして作成します。
  • 承認前にドラフト請求書の内容を編集します。
  • 販売請求書ライフサイクルの進行に合わせて、請求書を承認、無効化、メール送信します。
  • 承認済みまたは支払い済みの請求書を修正するためにクレジットノートを発行します。
  • 承認済み請求書に対する顧客支払いを記録します。
  • リテイナー、サブスクリプション、その他の定期請求用の繰り返し請求書テンプレートを設定します。
  • 顧客連絡先を作成および検索します。
  • 勘定科目コード、税率、アイテム、追跡カテゴリー、ブランドテーマなどの参照データを検索します。

プロンプト例

次のプロンプト例を使用して、Xero Billing and AR MCPサーバーツールを呼び出します:

  • Show me Acme Corp's open invoices.
  • Find invoice INV-0042.
  • Invoice Acme Corp $5,000 for consulting.
  • Approve the draft invoice for Acme Corp and send it.
  • Void the duplicate invoice I raised yesterday.
  • Acme Corp paid invoice INV-0042 today. Record the payment.
  • Issue Acme Corp a $500 credit note for a billing error.
  • Bill Acme Corp $2,000 on the first of every month for their retainer.
  • Which Xero organizations are connected to this account?
  • Find the contact record for Acme Corp.

Xero Billing and AR MCPサーバーツール

Xero Billing and AR MCPサーバーは次のツールを提供します:

ツール説明
list_organizationsこのコネクションに接続されたXero組織を一覧表示します。
search_invoices選択したXero組織の販売請求書を、連絡先、ステータス、番号、参照、日付範囲、または延滞状態で検索します。
get_invoiceこのサーバーの書き込みツールが判定に使用する前提条件の状態を含め、1つの販売請求書の完全な詳細を取得します。
create_invoice選択したXero組織で、販売請求書をドラフトとして、または直接承認済みとして作成します。
update_draft_invoice既存のドラフト販売請求書の内容を更新します。
authorize_invoice既存のドラフト販売請求書を承認し、支払い可能かつ共有可能にします。
void_invoice監査証跡を保持したまま、未払いの販売請求書を取り消し不能に無効化します。
send_invoice組織のデフォルトテンプレートを使用して、販売請求書を連絡先にメール送信します。
create_credit_note選択したXero組織でクレジットノートを作成します。
record_payment選択したXero組織で、承認済み販売請求書に対する顧客支払いを記録します。
create_repeating_invoiceスケジュールに従って請求書を生成する繰り返し販売請求書テンプレートを作成します。
search_customers選択したXero組織の顧客連絡先を、名前またはメールで検索します。
create_customer選択したXero組織で顧客連絡先を作成します。
list_reference_data選択した組織の読み取り専用参照データを返します。

Xero Billing and AR MCPサーバーのインストール

構築済みMCPサーバーをプロジェクトにインストールするには、次の手順を完了します:

1

Workatoアカウントにサインインします。

2

AI Hub > Enterprise MCPに移動します。

3

+ Create MCP serverをクリックします。

4

接続済みアプリを使用して構築済みMCPサーバーを開始するセクションに移動し、使用する構築済みMCPサーバーを選択します。

5

Use this serverをクリックします。

6

サーバー名フィールドにMCPサーバーの名前を入力します。

7

場所ドロップダウンメニューを使用して、MCPサーバーのプロジェクトを選択します。

8

Connectionsセクションに移動し、アプリアカウントに接続します。

9

MCPサーバーテンプレートで使用するコネクションタイプを選択します。

  • User's connection: MCPサーバーツールは、アプリケーションに接続するユーザーのIDと権限に基づいてアクションを実行します。 ユーザーは自分の認証情報で認証し、スキルを実行します。
  • Your connection: このオプションでは、レシピビルダーによって確立されたコネクションを使用し、通常のアプリコネクションと同じ原則に従います。

コネクションタイプを選択コネクションタイプを選択

検証済みユーザーアクセスの認証要件

OAuth 2.0認可コードグラントを使用するアプリコネクションのみが、ユーザーのコネクションで利用できます。 詳細については、検証済みユーザーアクセスを参照してください。

10

次のセクションで、アプリ固有のコネクション設定手順を完了します。

Xero Billing and ARコネクションのセットアップ

Xero Billing and ARコネクションのセットアップ手順を表示

APIバージョン

XeroコネクターはXero Accounting APIを使用します。 Workatoレシピとの連携の可能性を十分に理解するには、Xero Accounting APIのドキュメントを確認してください。

WorkatoでXeroに接続する方法

OAuthコネクションのセットアップ手順を表示

WorkatoでXeroに接続するには、次の手順を実行します:

1

Workatoに接続する予定のXeroインスタンスを識別する一意のコネクション名を入力します。

2

Xeroアカウントで給与計算が有効になっている場合は、Yesを選択します。 給与計算の接続は、AU版およびUS版でのみ利用できます。

3

コネクションの正確なテナント名を入力します。 このフィールドでは大文字と小文字が区別されます。

4

明細行計算に必要な小数精度を指定します。 このフィールドを空白のままにすると、デフォルトで2になります。

5

任意です。 Custom OAuth profileドロップダウンメニューを使用して、コネクション用のCustom OAuth profileを選択します。

6

接続をクリックしてXeroアカウントにサインインし、セットアッププロセスを完了します。

XeroログインXeroログイン

Xeroロール要件

各ツールの利用可否は、接続済みアカウントに付与された権限によって異なります。 必要な権限なしで行われたリクエストは、部分的な結果ではなく、権限拒否の結果を返します。 ロール機能の完全な一覧については、XeroのUser roles and permissions in Xero Business editionガイドを参照してください。

Xero Billing and AR MCPサーバーツールの使用方法

利用可能なツールの詳細については、次のセクションを参照してください:

list_organizationsツール

list_organizationsツールは、このコネクションに接続されたXero組織を一覧表示し、それぞれのTenant ID、名前、タイプを示します。 複数の組織が接続されている可能性がある場合、LLMは書き込み前にこのツールを使用してターゲット組織を検出または明確化します。

質問例:

  • Which Xero organizations are connected to this account?
  • Show me the Tenant ID for our UK entity.
  • List every Xero organization I can act on.

search_invoicesツール

search_invoicesツールは、選択したXero組織の販売請求書を、連絡先、ステータス、番号、参照、日付範囲、または延滞状態で検索します。 LLMはこのツールを使用して、自然な参照から請求書を検索し、対象に対して操作する前に必要な請求書IDを取得します。

質問例:

  • Show me Acme Corp's open invoices.
  • Find everything unpaid over 30 days.
  • List all invoices dated last month for Acme Corp.
  • Which invoices are overdue right now?

get_invoiceツール

get_invoiceツールは、1つの販売請求書の完全な詳細を取得します。これには、このサーバーの書き込みツールが判定に使用する前提条件の状態として、ステータス、未払い金額、適用済みの支払いとクレジット割り当て、連絡先に登録済みメールがあるかどうかが含まれます。 LLMはライフサイクルの書き込み前にこのツールを使用するため、2回目の検索は不要です。

質問例:

  • Show me the full details for invoice INV-0042.
  • What's the status and amount outstanding on this invoice?
  • Check whether this invoice's contact has an email on file before I send it.

create_invoiceツール

create_invoiceツールは、選択したXero組織で、既知の連絡先と明細項目に対して販売請求書をドラフトとして、または直接承認済みとして作成します。 LLMはこのツールを使用して新しい請求書を発行し、勘定科目コードと税率を作り出すのではなく検索します。

質問例:

  • Invoice Acme Corp $5,000 for consulting.
  • Create a draft invoice for Acme Corp so I can review it before approving.
  • Bill Acme Corp for 10 hours of consulting at $150 an hour.

update_draft_invoiceツール

update_draft_invoiceツールは、ドラフト販売請求書の内容を更新します。これには、連絡先、日付、明細項目、参照、通貨などが含まれます。 LLMは承認前にドラフトを変更するためにこのツールを使用します。

質問例:

  • Change the quantity on the Acme Corp draft invoice to 15 hours.
  • Fix the due date on this draft invoice.
  • Update the reference on the draft invoice for Acme Corp.

authorize_invoiceツール

authorize_invoiceツールは、既存のドラフト販売請求書を承認し、支払い可能かつ共有可能にします。 LLMは、内容を変更せずにドラフトを承認したい場合にこのツールを使用します。

質問例:

  • Approve the draft invoice for Acme Corp.
  • Authorize invoice INV-0042 so I can send it.
  • Approve this draft now that the amounts look right.

void_invoiceツール

void_invoiceツールは、監査証跡を保持したまま、未払いの販売請求書を取り消し不能に無効化します。 LLMは、ユーザーの明示的な確認があり、かつ支払いやクレジット割り当てが適用されていない場合にのみ、このツールを使用します。

質問例:

  • Void the duplicate invoice I raised yesterday.
  • Cancel invoice INV-0042 because it was never meant to be issued.
  • Yes, void that invoice, I'm sure it's a duplicate.

send_invoiceツール

send_invoiceツールは、組織のデフォルトテンプレートを使用して、共有可能な販売請求書を連絡先にメール送信します。 LLMはこのツールを使用して請求書を送信または再送信し、最初に共有可能ステータスと登録済みの連絡先メールを確認します。

質問例:

  • Email the approved invoice to Acme Corp.
  • Resend invoice INV-0042 to the customer.
  • Send this invoice now that it's approved.

create_credit_noteツール

create_credit_noteツールは、顧客クレジットノート(承認済みまたは支払い済みの販売請求書に対する認可された修正)をドラフトとして、または承認済みとして作成します。 LLMはこのツールを使用して、送信済み請求書を修正するか一部返金します。金額やコードを作り出すことはありません。

質問例:

  • Issue Acme Corp a $100 credit note for a billing error.
  • Issue a standalone credit note for Acme Corp.
  • Credit Acme Corp for an overcharge on their account.

record_paymentツール

record_paymentツールは、1つの承認済み販売請求書に対して、顧客から受領した支払いを記録します。 ユーザーが指定した金額、日付、受取口座を使用します。 LLMはこのツールを使用して、ユーザーが報告した支払いを記帳します。どの請求書に充当されるかを推測することはありません。

質問例:

  • Acme Corp paid invoice INV-0042 today. Record $5,000 into the main account.
  • Record a partial payment of $2,000 against this invoice.
  • Log the payment we just received from Acme Corp.

create_repeating_invoiceツール

create_repeating_invoiceツールは、スケジュールに従って繰り返し販売請求書テンプレートを作成し、生成される各請求書をドラフトとして保存するか、承認してメール送信するように設定します。 LLMはこのツールを使用して定期請求を設定し、頻度と生成モードをユーザーに確認します。

質問例:

  • Bill Acme Corp $2,000 on the first of every month for their retainer.
  • Set up a weekly repeating invoice for this subscription.
  • Create a recurring invoice template that auto-approves and emails each month.

search_customersツール

search_customersツールは、選択したXero組織の顧客連絡先を、名前またはメールで検索します。 LLMはこのツールを使用して、請求書、クレジットノート、または繰り返し請求書を作成する前に連絡先IDを取得し、送信前に連絡先に登録済みメールがあるかどうかを確認します。

質問例:

  • Find the contact record for Acme Corp.
  • Look up [email protected] in this organization.
  • Does Acme Corp have an email address on file?

create_customerツール

create_customerツールは、名前と任意のメールおよび詳細を含む新しい顧客連絡先を作成します。 LLMは、search_customersツールで一致する既存の連絡先がないことを確認した後、このツールを使用して新しい顧客連絡先を作成します。

質問例:

  • Create a new customer record for Acme Corp.
  • Add a contact for Acme Corp with their billing email.
  • Set up a new customer so I can invoice them.

list_reference_dataツール

list_reference_dataツールは、呼び出しごとに組織の1種類の参照データ(勘定科目表コード、税率、アイテム、追跡カテゴリー、またはブランドテーマ)を返します。 LLMはこのツールを使用して、有効なコードを作り出すのではなく提供し、支払いの受取口座を検索します。

質問例:

  • Which account codes are available for consulting revenue?
  • Show me the tax rates set up in this organization.
  • Find a payments-enabled account to record this payment against.

はじめに

MCP serverのツールは、Overviewページのツールセクションで表示および管理できます。 ツール管理では、次の機能を利用できます:

ツールを開始する必要があります

LLMは、MCP server connector内のアクティブなツールにのみアクセスできます。

最終更新日: