mcpField
M
mcp-conta-azul

mcp-conta-azul

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

mcp-conta-azul について

mcp-conta-azul は、会計と請求書発行に使われる ERP・財務管理プラットフォーム Conta Azul 向けの MCP サーバーです。売上や財務のデータをエージェントから扱いたい利用者に適しています。

主な機能

  1. 01顧客と商品の作成、参照、更新、削除
  2. 02サービス項目の管理
  3. 03売上の作成、参照、キャンセル
  4. 04財務サマリーと売掛金の一覧取得
  5. 05銀行口座とカテゴリの参照

活用シーン

  1. 01エージェントで売上記録と売掛金を照会
  2. 02エージェント経由で顧客、商品、売上を作成
  3. 03経営分析用に財務サマリーを取得

MCP 対応

本プロジェクトは MCP サーバーであり、Conta Azul API を呼び出す 20 のツールを MCP クライアントに提供します。顧客、商品、売上、財務データを管理できます。

設定

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

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

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

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

ツール

20

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

パラメーター型必須説明
pagenumberいいえページ番号（0 から開始）
sizenumberいいえ1 ページあたりの項目数（デフォルトは 20）
searchstringいいえ名前または書類番号で検索

詳細

@codespar/mcp-conta-azul

Conta Azul 向け MCP サーバー — ERP、会計、請求書発行、財務管理

npm License: MIT

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "conta-azul": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-conta-azul"],
      "env": {
        "CONTA_AZUL_ACCESS_TOKEN": "your-token"
      }
    }
  }
}
Claude Code
claude mcp add conta-azul -- npx @codespar/mcp-conta-azul
Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します：

{
  "servers": {
    "conta-azul": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-conta-azul"],
      "env": {
        "CONTA_AZUL_ACCESS_TOKEN": "your-token"
      }
    }
  }
}

ツール（20）

ツール用途
list_customersConta Azul の顧客一覧を取得
create_customerConta Azul に顧客を作成
update_customerConta Azul の顧客情報を更新
delete_customerConta Azul の顧客を削除
list_productsConta Azul の商品一覧を取得
create_productConta Azul に商品を作成
update_productConta Azul の商品情報を更新
delete_productConta Azul の商品を削除
list_salesConta Azul の売上一覧を取得
create_saleConta Azul に売上を作成
get_saleConta Azul で ID を指定して売上を取得
cancel_saleConta Azul の売上をキャンセル
list_servicesConta Azul のサービス一覧を取得
create_serviceConta Azul にサービスを作成
update_serviceConta Azul のサービス情報を更新
delete_serviceConta Azul のサービスを削除
get_financial_summaryConta Azul の財務概要を取得
list_categories商品／サービスのカテゴリ一覧を取得
list_bank_accountsConta Azul の銀行口座一覧を取得
list_accounts_receivableConta Azul の売掛金（入金予定の財務イベント）一覧を取得

認証

Conta Azul は認証に OAuth2 Bearer トークンを使用します。

サンドボックス／テスト

Conta Azul では OAuth フローを通じてサンドボックスを利用できます。テストにはサンドボックスの認証情報を使用してください。

認証情報を取得する
  1. Conta Azul Developer Portal にアクセスします
  2. 開発者として登録します
  3. OAuth アプリケーションを作成し、アクセストークンを取得します
  4. CONTA_AZUL_ACCESS_TOKEN 環境変数を設定します

環境変数

変数必須説明
CONTA_AZUL_ACCESS_TOKENはいOAuth2 アクセストークン

ロードマップ

v0.2（予定）
  • list_bank_accounts — 登録済み銀行口座の一覧を取得
  • create_bank_account — 新しい銀行口座を登録
  • list_taxes — 税項目の一覧を取得
  • create_tax — 税項目を作成
  • get_cash_flow — キャッシュフローの概要レポートを取得
v0.3（予定）
  • reconciliation — 銀行口座の照合ツール
  • financial_reports — 財務概要レポートを生成

コントリビュートをご希望ですか？PR を作成するか、ツールをリクエストしてください。

リンク

エンタープライズ

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

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

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

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