mcp-colppy

MCP Colppy

アルファ版リリース — alpha npm dist-tag で公開されています。エンドポイントのパスは公開ドキュメントと BACEN／プロバイダーの規約に準拠していますが、実環境での検証は完了していません。0.x.x-alpha の間は正確なバージョンを固定してください。npm install <pkg>@alpha でインストールします。

Colppy 用の MCP サーバー — AFIP 電子請求書発行機能を統合した、アルゼンチンのクラウド会計プラットフォームです。

クイックスタート

# Set your credentials
export COLPPY_API_KEY="your-api-key"
export COLPPY_COMPANY_ID="your-company-id"

# Run via stdio
npx tsx packages/argentina/colppy/src/index.ts

# Run via HTTP
npx tsx packages/argentina/colppy/src/index.ts --http

環境変数

変数	必須	説明
COLPPY_API_KEY	はい	Colppy の API キー
COLPPY_COMPANY_ID	はい	会社識別子
MCP_HTTP	いいえ	HTTP トランスポートを有効にするには "true" を設定します
MCP_PORT	いいえ	HTTP ポート（デフォルト：3000）

ツール（22）

ツール	目的
list_customers	顧客を一覧表示します
create_customer	顧客を作成します
list_products	商品とサービスを一覧表示します
create_invoice	請求書を作成します（電子請求書発行のため AFIP と連携します）
list_invoices	請求書を一覧表示します
get_balance	口座残高の概要を取得します
list_accounts	勘定科目一覧（plan de cuentas）を表示します
create_payment	請求書に対する支払いを記録します
update_customer	既存顧客のデータを更新します
delete_customer	顧客を削除します
get_customer_balance	顧客の現在の売掛残高（cuenta corriente）を取得します
list_suppliers	仕入先（proveedores）を一覧表示します
create_supplier	仕入先（proveedor）を作成します
cancel_invoice	請求書を取り消します（anular comprobante）
get_invoice_pdf	請求書の PDF 形式を取得します（URL または base64 を返します）
create_receipt	入金伝票（recibo）を作成します — 1 件以上の請求書に対して受領した現金／振込を記録します
list_receipts	入金伝票（recibos）を一覧表示します
get_stock	倉庫全体の商品在庫数を取得します
list_warehouses	倉庫（depósitos）を一覧表示します
list_companies	現在の API ユーザーがアクセスできる会社（empresas）を一覧表示します
sales_report	期間を指定した売上レポート
expenses_report	期間を指定した経費／仕入レポート

認証

API キー＋セッション認証を使用します。各リクエストでは API キーと会社 ID を送信します。Colppy は、リクエスト本文でサービスと操作を指定する JSON-RPC 形式の API を使用します。

API リファレンス

• Colppy API ドキュメント

---

エンタープライズ

エージェントによる支払いのガバナンス、予算上限、監査証跡が必要ですか？ CodeSpar Enterprise は、これらの MCP サーバー上にポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

認証

サーバーを起動する前に、次の環境変数を設定してください。

• COLPPY_API_KEY (必須、シークレット) — Colppy の API キー
• COLPPY_COMPANY_ID (必須) — 会社識別子

プロバイダーの開発者ポータルで認証情報を発行してください：https://api.colppy.com/.

ライセンス

MIT