mcpField
M
mcp-conta-azul

mcp-conta-azul

本地服务
github.com/codespar金融数据2754 周前更新
代码仓库

关于 mcp-conta-azul

mcp-conta-azul 是面向巴西 Conta Azul ERP 与财务管理平台的 MCP 服务，覆盖会计、开票、客户和产品管理。适合希望让 Agent 访问财务与销售数据的用户。

主要功能

  1. 01客户与产品的增删改查
  2. 02服务项目的管理
  3. 03销售单的创建、查询与取消
  4. 04财务概览与应收账款查询
  5. 05银行账户与商品分类查询

适用场景

  1. 01让 Agent 查询销售记录与应收账款
  2. 02通过自然语言创建客户、产品或销售单
  3. 03获取财务概览用于经营分析

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 20 个工具，用于调用 Conta Azul API 管理客户、产品、销售和财务数据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 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否每页项目数（默认 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_customers列出 Conta Azul 中的客户
create_customer在 Conta Azul 中创建客户
update_customer更新 Conta Azul 中的客户
delete_customer删除 Conta Azul 中的客户
list_products列出 Conta Azul 中的产品
create_product在 Conta Azul 中创建产品
update_product更新 Conta Azul 中的产品
delete_product删除 Conta Azul 中的产品
list_sales列出 Conta Azul 中的销售记录
create_sale在 Conta Azul 中创建销售记录
get_sale根据 id 获取 Conta Azul 中的销售记录
cancel_sale取消 Conta Azul 中的销售记录
list_services列出 Conta Azul 中的服务
create_service在 Conta Azul 中创建服务
update_service更新 Conta Azul 中的服务
delete_service删除 Conta Azul 中的服务
get_financial_summary获取 Conta Azul 的财务摘要
list_categories列出产品／服务类别
list_bank_accounts列出 Conta Azul 中的银行账户
list_accounts_receivable列出 Conta 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 或申请工具。

链接

企业版

需要为 Agent 付款设置治理、预算限制和审计追踪？CodeSpar Enterprise 可在这些 MCP 服务基础上添加策略引擎、付款路由和合规模板。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。