mcp-siigo について
mcp-siigo は、DIAN の電子請求書機能を統合したコロンビアの会計プラットフォーム Siigo 向けの MCP サーバーです。MCP クライアントから請求書、顧客、商品、仕入れ文書を管理したい利用者を対象としています。認証は API キーと Bearer アクセストークンを使用します。
主な機能
- 01DIAN 電子請求書の作成と PDF の取得
- 02クレジットノートの作成と照会
- 03顧客と商品の作成、取得、更新、削除
- 04仕入れ文書の作成と一覧取得
- 05倉庫、税区分、支払方法の照会
活用シーン
- 01MCP クライアントから DIAN 電子請求書を発行
- 02既存の請求書に対するクレジットノートを作成
- 03顧客、商品、倉庫の基本データを照会
MCP 対応
本プロジェクトは MCP サーバーであり、Siigo API の請求書、顧客、商品、文書を扱う 22 個のツールを MCP クライアントに提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
22掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| date | string | はい | 請求書の日付(YYYY-MM-DD) |
| items | array | はい | 請求書の項目 |
| customer | object | はい | 顧客参照 |
| customer.branch_office | number | いいえ | 支店(デフォルトは 0) |
| customer.identification | string | はい | 顧客の NIT または CC |
| document | object | はい | 書類の種類 |
| document.id | number | はい | 書類タイプ ID |
| payments | array | はい | 支払い方法 |
詳細
MCP Siigo
Siigo 向け MCP サーバーです。Siigo は、DIAN 電子請求書発行機能を統合したコロンビアの会計プラットフォームです。
クイックスタート
# Set your credentials
export SIIGO_API_KEY="your-api-key"
export SIIGO_ACCESS_TOKEN="your-access-token"
# Run via stdio
npx tsx packages/colombia/siigo/src/index.ts
# Run via HTTP
npx tsx packages/colombia/siigo/src/index.ts --http
環境変数
| 変数 | 必須 | 説明 |
|---|---|---|
SIIGO_API_KEY | はい | Siigo の API キー |
SIIGO_ACCESS_TOKEN | はい | ベアラーアクセストークン |
MCP_HTTP | いいえ | HTTP トランスポートを有効にするには "true" に設定します |
MCP_PORT | いいえ | HTTP ポート(デフォルト:3000) |
ツール(22)
| ツール | 用途 |
|---|---|
create_invoice | 請求書(DIAN 電子請求書)を作成します |
get_invoice | ID を指定して請求書の詳細を取得します |
list_invoices | 請求書の一覧を取得します |
create_credit_note | 請求書に対するクレジットノートを作成します |
list_customers | 顧客の一覧を取得します |
create_customer | 顧客を作成します |
list_products | 商品の一覧を取得します |
create_product | 商品を作成します |
get_invoice_pdf | 請求書の PDF 文書を取得します |
get_credit_note | ID を指定してクレジットノートを取得します |
list_credit_notes | クレジットノートの一覧を取得します |
update_customer | 既存の顧客を更新します |
delete_customer | 顧客を削除します |
update_product | 既存の商品を更新します |
delete_product | 商品を削除します |
create_purchase | 購買文書を作成します |
list_purchases | 購買文書の一覧を取得します |
list_document_types | 文書の種類を一覧表示します(例:請求書は FV、クレジットノートは NC、購買は FC) |
list_users | Siigo ユーザー(販売担当者)の一覧を取得します |
list_warehouses | 倉庫(bodegas)の一覧を取得します |
list_taxes | 利用可能な税種の一覧を取得します |
list_payment_methods | 利用可能な支払方法の一覧を取得します |
認証
ベアラートークン認証を使用します。Siigo 開発者ポータルからアクセストークンを取得してください。
API リファレンス
エンタープライズ
エージェントによる支払いに、ガバナンス、予算上限、監査証跡が必要ですか?CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。
認証
サーバーを起動する前に、次の環境変数を設定してください。
SIIGO_API_KEY(必須、シークレット) — Siigo の API キーSIIGO_ACCESS_TOKEN(必須、シークレット) — ベアラーアクセストークン
認証情報はプロバイダーの開発者ポータルで発行してください:https://siigoapi.docs.apiary.io。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。