Mcp Conta Azul

io.github.codespar由 GitHub 帳號 codespar 發布v0.2.2更新於 Oct 24, 2026

MCP server for Conta Azul — accounting, invoicing, customers, products

發布方自己的服務：Azul CR — Costa Rica Local Business Data

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理連接 Conta Azul ERP，處理會計、開票、客戶、產品、銷售與財務彙總。

可以做什麼
在 Conta Azul 中列出、建立、更新與刪除客戶和產品，並列出產品與服務分類及銀行帳戶。列出、建立、查詢與取消銷售單，以及列出、建立、更新與刪除服務。取得財務彙總並列出應收帳款。所有操作透過 OAuth2 持有者權杖呼叫 Conta Azul API 完成。
適用情境
當你以 Conta Azul 作為 ERP，希望助理查詢或維護客戶、產品、服務、銷售與應收資料，或快速取得財務彙總而不必開啟網頁介面時適用。
執行需求
透過 npx 從 npm 套件 @codespar/mcp-conta-azul 在本機執行，需要 Node.js。需要 Conta Azul OAuth2 存取權杖，透過環境變數 CONTA_AZUL_ACCESS_TOKEN 提供，須在 Conta Azul 開發者入口註冊應用程式後取得。需要連線至 Conta Azul API 的網路存取。提供沙箱環境供測試。
安裝前請注意
CONTA_AZUL_ACCESS_TOKEN 中的權杖可存取真實會計資料，應妥善保密。多個工具會寫入 ERP：建立、更新與刪除客戶、產品和服務，建立銷售單以及取消銷售單。刪除與取消銷售可能影響財務紀錄，讓助理執行前應先確認。README 另提到一套含付款路由的企業版服務，不屬於此伺服器。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Conta Azul，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@codespar/mcp-conta-azul

MCP server for Conta Azul — ERP, accounting, invoicing, and financial management

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

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

Claude Code

bash
claude mcp add conta-azul -- npx @codespar/mcp-conta-azul

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

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

Tools (20)

ToolPurpose
list_customersList customers in Conta Azul
create_customerCreate a customer in Conta Azul
update_customerUpdate a customer in Conta Azul
delete_customerDelete a customer in Conta Azul
list_productsList products in Conta Azul
create_productCreate a product in Conta Azul
update_productUpdate a product in Conta Azul
delete_productDelete a product in Conta Azul
list_salesList sales in Conta Azul
create_saleCreate a sale in Conta Azul
get_saleGet a sale by id in Conta Azul
cancel_saleCancel a sale in Conta Azul
list_servicesList services in Conta Azul
create_serviceCreate a service in Conta Azul
update_serviceUpdate a service in Conta Azul
delete_serviceDelete a service in Conta Azul
get_financial_summaryGet financial summary from Conta Azul
list_categoriesList product/service categories
list_bank_accountsList bank accounts in Conta Azul
list_accounts_receivableList accounts receivable (financial events to receive) in Conta Azul

Authentication

Conta Azul uses OAuth2 Bearer tokens for authentication.

Sandbox / Testing

Conta Azul provides a sandbox via the OAuth flow. Use sandbox credentials for testing.

Get your credentials

  1. Go to Conta Azul Developer Portal
  2. Register as a developer
  3. Create an OAuth application and obtain an access token
  4. Set the CONTA_AZUL_ACCESS_TOKEN environment variable

Environment Variables

VariableRequiredDescription
CONTA_AZUL_ACCESS_TOKENYesOAuth2 access token

Roadmap

v0.2 (planned)

  • list_bank_accounts — List registered bank accounts
  • create_bank_account — Register a new bank account
  • list_taxes — List tax entries
  • create_tax — Create a tax entry
  • get_cash_flow — Get cash flow summary report

v0.3 (planned)

  • reconciliation — Bank reconciliation tools
  • financial_reports — Generate financial summary reports

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

來源：packages/fiscal/conta-azul/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Azul 整合

Azul CR — Costa Rica Local Business Data

cr.azul官方發布者

以唯讀方式存取哥斯大黎加在地商家目錄的 MCP 服務：可搜尋商家、職缺、活動與優惠，選用金鑰可解鎖聯絡方式。

Streamable HTTP可網頁執行
位置與生活6 個工具Oct 27, 2026

Conta Azul MCP

由 GitHub 帳號 douglac 發布

透過 OAuth 2.0 連接 Conta Azul ERP，讓助理讀寫銷售、客戶、產品、財務與發票資料。

Streamable HTTP可網頁執行
效率與工作流58 個工具Oct 27, 2026