mcp-alegra

Name: mcp-alegra
Author: codespar

ローカル

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

リポジトリ

mcp-alegra について

MCP Alegra は、ラテンアメリカ向けクラウド会計プラットフォーム Alegra の MCP サーバーです。請求書、連絡先、商品、支払いを扱い、アカウントのメールアドレスと API トークンで認証します。

主な機能

01請求書、連絡先、商品、支払いを扱う 20 のツール
02stdio と HTTP の両方のトランスポートに対応
03メールアドレスと API トークンによる Basic 認証
04アイテムカテゴリと銀行口座の一覧取得

活用シーン

01MCP クライアントから請求書を作成、一覧表示、無効化
02顧客と仕入先の連絡先および商品情報の管理
03支払いの記録と会社設定の確認

設定

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

mcp.json · 共通設定

{
  "mcpServers": {
    "codespar-mcp-alegra": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-alegra"
      ],
      "env": {
        "ALEGRA_EMAIL": "<ALEGRA_EMAIL>",
        "ALEGRA_API_TOKEN": "<ALEGRA_API_TOKEN>"
      }
    }
  }
}

起動コマンドnpx -y @codespar/mcp-alegra

設定が必要な環境変数

ALEGRA_EMAILAccount email for Alegra

ALEGRA_API_TOKENシークレットAPI token for Alegra

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

パッケージ

npm@codespar/mcp-alegra0.2.2stdio

ツール

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

パラメーター	型	必須	説明
date	string	はい	請求書の日付（YYYY-MM-DD）
items	array	はい	請求書の項目
stamp	object	いいえ	電子請求書スタンプ（DIAN 用）
stamp.generate_stamp	boolean	いいえ	電子スタンプを生成します
client	number	はい	クライアント／連絡先 ID
currency	string	いいえ	通貨コード（COP、USD、MXN）
due_date	string	はい	期限日（YYYY-MM-DD）
observations	string	いいえ	備考／説明
payment_method	string	いいえ	支払い方法

詳細

MCP Alegra

Alegra 用の MCP サーバーです。LATAM 向けのクラウド会計プラットフォーム（コロンビア発）で、CO、MX、AR、CL などで請求書発行、連絡先、在庫、支払いに対応しています。

クイックスタート

# Set your credentials
export ALEGRA_EMAIL="[email protected]"
export ALEGRA_API_TOKEN="your-api-token"

# Run via stdio
npx tsx packages/colombia/alegra/src/index.ts

# Run via HTTP
npx tsx packages/colombia/alegra/src/index.ts --http

環境変数

変数	必須	説明
`ALEGRA_EMAIL`	はい	アカウントのメールアドレス
`ALEGRA_API_TOKEN`	はい	Alegra の設定から取得する API トークン
`MCP_HTTP`	いいえ	HTTP トランスポートを有効にするには `"true"` に設定します
`MCP_PORT`	いいえ	HTTP ポート（デフォルト：3000）

ツール（20）

ツール	用途
`create_invoice`	請求書を作成します
`get_invoice`	ID を指定して請求書の詳細を取得します
`list_invoices`	請求書の一覧を取得します
`void_invoice`	請求書を無効化／キャンセルします
`get_invoice_pdf`	請求書 PDF のダウンロード URL を取得します
`send_invoice`	1 人以上の宛先に請求書をメールで送信します
`create_contact`	連絡先（顧客または仕入先）を作成します
`update_contact`	既存の連絡先を更新します
`delete_contact`	連絡先を削除します
`list_contacts`	連絡先の一覧を取得します
`create_item`	商品またはサービスの品目を作成します
`update_item`	既存の品目を更新します
`list_items`	商品とサービスの一覧を取得します
`list_payments`	支払いの一覧を取得します
`get_payment`	ID を指定して支払いを取得します
`create_payment`	支払いを記録します
`void_payment`	支払いを無効化／取り消します
`list_categories`	品目カテゴリ（勘定科目表）の一覧を取得します
`list_bank_accounts`	銀行口座の一覧を取得します
`get_company`	会社のプロフィールと設定を取得します

認証

メールアドレスと API トークンを使用したBasic 認証を使用します。Alegra の設定ページにある「API」セクションから API トークンを取得してください。

API リファレンス

Alegra API ドキュメント

エンタープライズ

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

認証

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

ALEGRA_EMAIL (必須) — Alegra アカウントのメールアドレス
ALEGRA_API_TOKEN (必須、シークレット) — Alegra の API トークン

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

ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

作者: codespar
言語: node
バージョン: 0.2.2
トランスポート: stdio
掲載日: 2026年6月22日
最終更新: 4 週間前
公式 Registry: io.github.codespar/mcp-alegra

問題を報告

MCP は初めてですか？

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

入門ガイドを読む

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

mcp-alegra

mcp-alegra について

主な機能

活用シーン

設定

ツール

詳細

MCP Alegra

クイックスタート

環境変数

ツール（20）

認証

API リファレンス

エンタープライズ

認証

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？