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

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

Quaderno + Cursor

AI から Quaderno の税計算と請求業務を操作できます。あらゆる地域の売上税、VAT、GST を計算し、VAT 番号を検証し、連絡先、請求書、クレジットノート、見積書、経費、商品を検索し、請求書を発行してメールで送信し、税務レポートを依頼できます。

前提条件

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

QUADERNO_ACCOUNT_NAME, QUADERNO_API_KEY

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

1. https://quadernoapp.com にサインインし、Profile → API keys（https://quadernoapp.com/users/api-keys）を開きます。
2. sk_ で始まる 秘密鍵（private key） を QUADERNO_API_KEY にコピーします。公開可能キー（pk_）はここでは使えません。キーは HTTP Basic のユーザー名として空のパスワードと一緒に、あなたの Quaderno アカウントにのみ送信されます。
3. 同じページに API の URL が表示されます（例: https://acme-1234.quadernoapp.com/api/）。.quadernoapp.com の前の部分（この例では acme-1234）を QUADERNO_ACCOUNT_NAME に入れ、コネクタをインストールします。
4. quaderno_ping で設定を確認します。キーが有効かどうかと、現在の時間枠で残っているリクエスト数が表示されます。

請求書の発行と送信はあなたの承認後にのみ: 発行済みの請求書は税務上の正式な書類です。Quaderno は連番を振り、削除はできず、Quaderno アプリで無効化するかクレジットノートで取り消すしかありません。quaderno_create_invoice の前に、AI は顧客、明細、価格、通貨を示します。請求書をすぐに顧客へメール送信し、取り消せない quaderno_deliver_invoice の前には、どの請求書をどのアドレスに送るかを伝えます。quaderno_create_contact と quaderno_request_report も先に確認します。請求書を作成しただけでは送信されません。quaderno_delete_contact はインストール時にオフになっています。

税計算: quaderno_calculate_tax は、あらゆる地域への販売について売上税、VAT、GST を返します。税の名称、税率、税額、小計と合計、市区レベルまでの課税管轄、有効な EU の VAT 番号に対するリバースチャージなどの注意事項です。計算するだけで、何も記録しません。quaderno_validate_tax_id は、VAT 番号や事業者番号をその国の公式な登録簿（EU の VIES、英国、スイス、ケベック、オーストラリア、ニュージーランド）で確認します。

読み取れる内容: 連絡先、請求書、クレジットノート、見積書（Quaderno ではプロフォーマと呼びます）、経費、商品、課税管轄、税コード。税務レポート（申告用の課税管轄別の徴収税額、請求書一覧、クレジットノート一覧）はバックグラウンドで作成されます。AI が期間を指定して依頼し、完成するまで確認して、ダウンロードリンクを渡します。

機密データ: 請求書と連絡先には顧客の氏名、住所、税番号が含まれ、税務上の記録でもあります。請求業務を担当する人とだけ共有してください。

金額: _cents で終わる項目はセント単位です（12345 は 123.45）。価格と税計算の結果は通貨単位です。

レート制限: 15 秒あたり 100 回。429 が返ったら、時間枠がリセットされるまで待ちます。

よくあるエラー: 401 Wrong API key or the user does not exist: キーが間違っている、pk_ キーである、または QUADERNO_ACCOUNT_NAME とは別のアカウントのキーです。406: 不明な税コードなど、無効な値です。422: そのままでは書類を作成できません（明細がないなど）。

対象外: 請求書の更新、無効化、回収不能としての処理、入金の記録、領収書、定期発行の書類、トランザクション、チェックアウトセッションとクーポン、所在地の証拠、Webhook、Sandbox、Quaderno Connect のアカウント。

ステップ 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. チャットを始めましょう。エージェントが Quaderno のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「フランスのリヨンの個人に 49 EUR の SaaS サブスクリプションを販売する場合、VAT はいくらですか？同じ場所で有効な VAT 番号を持つ企業の場合は？」
• 「VAT 番号 DE123456789 は有効ですか？」
• 「まだ未払いまたは期限切れの請求書はどれですか？通貨ごとの合計額も教えてください。」
• 「Northwind GmbH 宛てに、コンサルティング 10 時間、1 時間 120 EUR の請求書を発行してください。作成する前にすべて見せて、まだメールでは送らないでください。」
• 「第 3 四半期の税サマリーレポートを依頼して、できあがったらダウンロードリンクを教えてください。」

FAQ

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

次のステップ

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