mcpField
M
mcp-siigo

mcp-siigo

ローカル
github.com/codespar金融データ2754 週間前に更新

mcp-siigo について

mcp-siigo は、DIAN の電子請求書機能を統合したコロンビアの会計プラットフォーム Siigo 向けの MCP サーバーです。MCP クライアントから請求書、顧客、商品、仕入れ文書を管理したい利用者を対象としています。認証は API キーと Bearer アクセストークンを使用します。

主な機能

  1. 01DIAN 電子請求書の作成と PDF の取得
  2. 02クレジットノートの作成と照会
  3. 03顧客と商品の作成、取得、更新、削除
  4. 04仕入れ文書の作成と一覧取得
  5. 05倉庫、税区分、支払方法の照会

活用シーン

  1. 01MCP クライアントから DIAN 電子請求書を発行
  2. 02既存の請求書に対するクレジットノートを作成
  3. 03顧客、商品、倉庫の基本データを照会

MCP 対応

本プロジェクトは MCP サーバーであり、Siigo API の請求書、顧客、商品、文書を扱う 22 個のツールを MCP クライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"codespar-mcp-siigo": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-siigo"
],
"env": {
"SIIGO_API_KEY": "<SIIGO_API_KEY>",
"SIIGO_ACCESS_TOKEN": "<SIIGO_ACCESS_TOKEN>"
}
}
}
}
起動コマンドnpx -y @codespar/mcp-siigo
設定が必要な環境変数
SIIGO_API_KEYシークレットAPI key for Siigo
SIIGO_ACCESS_TOKENシークレットBearer access token

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@codespar/mcp-siigo0.2.2

ツール

22

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
datestringはい請求書の日付(YYYY-MM-DD)
itemsarrayはい請求書の項目
customerobjectはい顧客参照
customer.branch_officenumberいいえ支店(デフォルトは 0)
customer.identificationstringはい顧客の NIT または CC
documentobjectはい書類の種類
document.idnumberはい書類タイプ ID
paymentsarrayはい支払い方法

詳細

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_invoiceID を指定して請求書の詳細を取得します
list_invoices請求書の一覧を取得します
create_credit_note請求書に対するクレジットノートを作成します
list_customers顧客の一覧を取得します
create_customer顧客を作成します
list_products商品の一覧を取得します
create_product商品を作成します
get_invoice_pdf請求書の PDF 文書を取得します
get_credit_noteID を指定してクレジットノートを取得します
list_credit_notesクレジットノートの一覧を取得します
update_customer既存の顧客を更新します
delete_customer顧客を削除します
update_product既存の商品を更新します
delete_product商品を削除します
create_purchase購買文書を作成します
list_purchases購買文書の一覧を取得します
list_document_types文書の種類を一覧表示します(例:請求書は FV、クレジットノートは NC、購買は FC)
list_usersSiigo ユーザー(販売担当者)の一覧を取得します
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

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。