Tupana

Tupana MCP

Tupana のリモート MCP サーバーです。Claude、ChatGPT、Cursor、または互換性のあるエージェントを、チリの電子請求書発行（SII）、入金回収、銀行照合、売上レポートに接続します。

https://mcp.tupana.ai/mcp

• トランスポート： Streamable HTTP。
• 認証： PKCE とクライアントの動的登録に対応した OAuth 2.1 です。接続すると、クライアントがブラウザーを開き、Tupana にログインしてアクセスを許可するよう求めます。API キーをコピーする必要はありません。
• スコープ： tupana:read と tupana:write。
• プライバシー： 各ユーザーには、Tupana でアクセス権のある企業のみが表示されます。すべてのツールは、その範囲内の書類と企業を参照します。
• セキュリティ： 元に戻せない操作（SII への発行、メール送信、照合）では、確認を求めるよう設計されています。発行は別の手順です。エージェントが下書きを作成し、PDF のプレビューを表示した後、承認を得てから emit_document で発行します。

アカウントをまだお持ちでない場合は、developers.tupana.ai で作成してください。

依頼できること

• 「今月の請求額と、上位 10 社の顧客を教えてください。」
• 「76.123.456-7 宛てに、1 時間あたり $45.000 + IVA で 3 時間のコンサルティング費用を請求してください。発注書 OC 4500123 を参照してください。」
• 「入金待ちで、30 日以上経過している請求書はどれですか？」
• 「昨日の銀行取引を、該当する請求書と照合してください。」
• 「9 月の IVA の概要と F29 を表示してください。」
• 「この SaaS にチリの電子請求書発行機能を追加してください。」（MCP は連携の構築方法も案内します）

接続

Claude（claude.ai と Claude Desktop）

1. Settings → Connectors → Add custom connector に移動します。
2. 名前に Tupana、URL に https://mcp.tupana.ai/mcp を入力します。
3. Connect をクリックし、Tupana にログインしてアクセスを許可します。

Team プランと Enterprise プランでは、管理者が組織全体にコネクターを追加できます。

Claude Code

claude mcp add --transport http tupana https://mcp.tupana.ai/mcp

続いて Claude Code 内で /mcp を実行し、tupana を選択して、ブラウザーでログインします。チームで共有するには、--scope project を指定して追加します（.mcp.json に保存されます）。

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）に記述します。

{
  "mcpServers": {
    "tupana": {
      "url": "https://mcp.tupana.ai/mcp"
    }
  }
}

Cursor はサーバーが OAuth を要求していることを検知し、ログインボタンを表示します。

ChatGPT

1. Settings → Apps & Connectors → Advanced settings → Developer mode を有効にします（プランによって利用できます）。
2. Apps & Connectors で新しいコネクターを作成し、URL に https://mcp.tupana.ai/mcp を入力して、認証方式に OAuth を選択します。
3. Tupana アカウントで認証し、チャットで有効にします。

VS Code（GitHub Copilot）

.vscode/mcp.json に記述します。

{
  "servers": {
    "tupana": {
      "type": "http",
      "url": "https://mcp.tupana.ai/mcp"
    }
  }
}

その他のクライアント

リモート MCP（Streamable HTTP + OAuth 2.1）に対応したクライアントであれば、同じ URL で利用できます。サーバーは次の場所でメタデータを公開しています。

• https://mcp.tupana.ai/.well-known/oauth-protected-resource
• https://mcp.tupana.ai/.well-known/oauth-authorization-server

クライアントが stdio のみに対応している場合は、mcp-remote などのブリッジを使用してください。

{
  "mcpServers": {
    "tupana": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tupana.ai/mcp"]
    }
  }
}

独自のエージェントから接続する

tupana-ai/tupana-examples には、発行前に確認を求める Python エージェント（Claude API + MCP クライアント）があります。

ツール

書類と請求

ツール	機能
get_documents	税務書類（請求書、レシート、クレジットノートなど）を照会します。
search_documents	顧客、金額、またはフォリオ番号で発行済み書類を検索します。
get_document_link	発行済み書類のリンク（PDF）を取得します。
create_sale_invoice	参照情報（OC 801、HES）を含む課税対象（33）または非課税（34）の請求書のドラフトを作成します。
create_purchase_invoice	仕入請求書（46）のドラフトを作成します。
create_export_invoice	輸出請求書（110）のドラフトを作成します。
create_receipt	レシート（39 または 41）のドラフトを作成します。
create_fee_receipt	報酬レシートのドラフトを作成します。
create_dispatch_guide	出荷伝票（52）のドラフトを作成します。
create_credit_note	請求書を参照するクレジットノート（61）を作成します（取り消しまたは訂正）。
create_debit_note	請求書を参照するデビットノート（56）を作成します。
parse_spreadsheet_to_invoices	スプレッドシートを請求書のドラフトに変換します（一括請求）。
get_document_preview / get_document_previews	1 件または複数のドラフトの PDF プレビューを表示し、確認できるようにします。
emit_document / emit_documents	確認済みのドラフト 1 件または複数件をSII に発行します。事前のプレビューが必要です。
send_document_email	発行済み書類をメールで再送します。
create_scheduled_invoice	予約請求書（定期請求）を作成します。
get_scheduled_documents	予約済み書類の一覧を取得します。
parse_document_to_invoice	発注書または PDF から項目を抽出し、請求書を作成します。

顧客、サプライヤー、企業

ツール	機能
get_entity_info	Tupana に登録されている自社の企業を取得します。
find_clients	顧客（受取人）を検索します。
enrich_client_from_rut	RUT をもとに、SII の納税者情報を取得します。
get_suppliers	受領した仕入請求書に基づくサプライヤーを取得します。
get_top_clients	請求金額または請求件数で顧客をランキング表示します。
get_top_products	販売した製品または項目をランキング表示します。
get_cross_sell_clients	ある製品を購入したが、別の製品は購入していない顧客を取得します。

レポート、帳簿、税金

ツール	機能
report_documents	月、種類、顧客、またはステータス別に発行済み書類の合計を取得します。
get_monthly_revenue	月次売上の推移を取得します。
get_sii_books	SII の仕入帳簿と売上帳簿を取得します。
get_f29_summary	対象期間の F29 の概要を取得します。
get_tax_summary	仕入税額控除と売上税額の概要を取得します。

債権回収と銀行照合

ツール	機能
get_pending_invoices	未払い請求書（売掛金と買掛金）を取得します。
get_bank_movements	銀行取引と照合ステータスを取得します。
get_payment_documents	支払書類（種類 100）を取得します。
get_reconciliation_suggestions	自動スコア付きの照合候補を取得します。
reconcile_movement	銀行取引を 1 件または複数の請求書と照合します。
get_reconciliations	照合履歴を取得します。

請求書の譲渡（ファクタリング）

ツール	機能
prepare_cession	発行済み請求書をファクタリング会社に譲渡する準備をします。
execute_cession	準備と確認が完了した譲渡を SII で実行します。
get_cession_status	譲渡のステータスを取得します。

SII の企業公開データベース

ツール	機能
search_sii_companies	SII の公開企業名簿からチリの企業を検索します。
find_sii_prospects	業種、地域、規模で見込み顧客を検索します。
find_growing_sii_companies	2 年間で成長した企業を検索します。
get_sii_company_history	企業の名簿上の推移を取得します。
get_sii_market_summary	市場規模（企業数と従業員数）を取得します。
get_sii_companies_metadata	利用可能なフィルター（年、規模区分、地域、業種）を取得します。

SaaS で請求書を作成する

ツール	内容
get_capabilities	Tupana でできることと、どのツールから始めればよいかを確認します。
get_invoice_flow	請求書発行の全フローをステップごとに確認します。
get_invoice_ui_spec	フロントエンドの仕様（フィールド、型、条件）を確認します。
get_invoice_validation_schema	ステップとフィールドごとの下書きの検証ルールを確認します。
validate_invoice_draft	API と同じルールで下書きを検証します。
get_customer_lookup_flow	RUT から法人名、事業内容、住所を調べます。
get_invoice_item_rules	請求書の明細ルールを確認します。
get_invoice_reference_rules	書類の種類に応じた参照ルールを確認します。
get_invoice_preview_flow	プレビューのリクエスト方法と表示方法を確認します。
get_invoice_issuance_flow	発行方法、状態の種類、返される内容を確認します。
get_async_strategy	スタックに応じて、Webhook ＋ WebSocket またはポーリングを確認します。
get_integration_setup	API キー、登録、Webhook、サンドボックスについて確認します。
get_invoice_contract_findings	コードで確認済みのルールと、宣言されているルールを確認します。
get_error_resolution	Tupana または SII のエラーの意味と対処方法を確認します。
get_design_system	Tupana のデザインシステムのトークンを確認します。

企業の接続とナビゲーション

ツール	内容
get_tupana_connect_guide	Tupana Connect で企業を登録する方法を確認します。
open_tupana_connect	Tupana Connect を開き、リンクを返します（SII 請求書発行、SII データの読み取り、または銀行）。
get_app_link	インターフェース上で行う操作に対応する、アプリ画面への直接リンクを取得します。
get_app_guide	アプリのナビゲーションガイドを確認します。
list_capabilities	「何ができますか？」に回答します。
how_to	タスクの手順をステップごとに説明します。

この一覧は、このリポジトリの公開時点のサーバーを反映しています。正しい情報は、サーバー自体の tools/list を参照してください。

ディレクトリ

• 公式 MCP Registry： server.json（io.github.tupana-ai/tupana）。公開または更新するには、GitHub OIDC で認証するワークフロー Publicar en el MCP Registry（Actions → Run workflow）を実行するか、手元のマシンから次を実行します。

  brew install mcp-publisher
  mcp-publisher login github   # con una cuenta miembro de la organización tupana-ai
  mcp-publisher publish
  

• Glama： glama.json でメンテナーを宣言しています。Glama はこのリポジトリをサーバーとして（glama.ai/mcp/servers/tupana-ai/tupana-mcp）、リモートエンドポイントをコネクターとして（glama.ai/mcp/connectors/io.github.tupana-ai/tupana）インデックス化します。

• Smithery： smithery.ai/new で URL を指定して公開します（または smithery mcp publish "https://mcp.tupana.ai/mcp" -n @tupana/tupana を実行します）。リポジトリに設定ファイルは必要ありません。

リソース

• ドキュメント：docs.tupana.ai
• 開発者ポータル：developers.tupana.ai
• 公式 SDK：Node.js npm install tupana（npm · GitHub）· Python pip install tupana（PyPI · GitHub）
• サンプル：tupana-ai/tupana-examples
• サポート：[email protected]

ライセンス

このリポジトリのドキュメントとファイルは、MIT ライセンスの下で提供されています。MCP サーバーは Tupana がホストするサービスです。

---

英語の概要

Tupana のリモート MCP サーバーです。チリの電子請求書（SII）、入金回収、銀行照合、売上レポート、請求書の債権譲渡を、https://mcp.tupana.ai/mcp で利用できます（Streamable HTTP、PKCE を使用した OAuth 2.1、動的クライアント登録、スコープ tupana:read／tupana:write）。Claude ではカスタムコネクターとして追加できます。Claude Code では claude mcp add --transport http tupana https://mcp.tupana.ai/mcp を実行し、Cursor または VS Code では mcp.json を使用します。ChatGPT では開発者モードのコネクターとして追加できます。取り消せない操作（SII への発行、メール送信、照合）は、確認を必要とするように設計されています。エージェントがドラフトを作成して PDF プレビューを表示し、承認後にのみ emit_document で発行します。レジストリのメタデータは server.json（io.github.tupana-ai/tupana）にあります。