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