Cartena MCP

🚀 Cartena MCP服务器

该项目实施了一个模型上下文协议（MCP）服务器，该服务器将 Cartena 的工具暴露于兼容的 AI 客户端，例如 Claude。

支持两种使用模式：

• 通过OAuth远程访问 ⭐ — 没有安装，推荐给大多数用户
• 通过stdio本地 用于开发或无互联网接入的环境

______________________________________________________________________

📦 安装

1.通过Oauth远程MCP⭐ （推荐）

使用 MCP 文件夹最简单和推荐的方法是通过远程服务器，无需在本地安装任何东西。验证是通过 OAuth也就是说，您授权直接通过浏览器访问您的卡帐户。

远程服务器 URL ：

https://mcp.cartena.com.br/mcp

在 Claude.ai 中配置

1. 注册连接器：

1. 访问 claude.ai 并打开 设置
2. 转到本节 连接器 na barra侧向
3. Clique em 添加自定义连接器 并报告URL ：

   https://mcp.cartena.com.br/mcp

1. 确认保存

2. 链接您的帐户：

1. 在连接器列表中， 查找或 卡特尔 e拉他们 关联

Conector Cartena com botão Vincular

1. 一个窗口将打开，请求您的 代币卡特尔

> 在下面找到您的代币： 文件夹 → 安全

Tela de autorização solicitando o token Cartena

1. 粘贴令牌并单击 允许访问

1. 屏幕 连接的 确认认证成功 — 您可以关闭标签

Tela de confirmação Conectado

1. 连接器将准备好用于您的对话

Conector Cartena configurado com sucesso

通过文件配置（ 兼容的 MCP 客户端）

对于支持 OAuth 远程 MCP 的客户端（如最新版本的 Claude Desktop）：

{
  "mcpServers": {
    "cartena": {
      "url": "https://mcp.cartena.com.br/mcp"
    }
  }
}

客户端将在第一次连接时自动处理 OAuth 身份验证流程。

______________________________________________________________________

2. 使用您的 npx❌ （不推荐）

注意：您的凭据将在不安全的环境中暴露。

要使用不安装， 通过 npx:

{
  "mcpServers": {
    "cartena": {
      "command": "npx",
      "args": [
        "-y",
        "github:cartena-tecnologia/cartena-mcp"
      ],
      "env": {
        "CARTENA_TOKEN": "SEU_TOKEN_AQUI"
      }
    }
  }
}

______________________________________________________________________

🔐 环境变量

只需要本地安装（npx或node）。在远程 MCP 中，通过 OAuth 进行身份验证。

• CARTENA_TOKEN用于访问内部API的身份验证令牌

例如：

CARTENA_TOKEN=seu_token_aqui

______________________________________________________________________

🧠 如何运作

MCP 服务器显示可用的工具（ M）tools/list接听电话（tools/call） 并将请求转发到文件夹后端 API。流量因使用方式而异：

远程模式： 人工智能客户端（例如 Claude）直接连接到托管在 https://mcp.cartena.com.br/mcp 通过HTTPS。通过 OAuth 进行身份验证，无需本地安装。

莫多当地： 服务器通过用户计算机上的stdio作为子进程启动，并通过验证进行 CARTENA_TOKEN 在环境变量中。

______________________________________________________________________

🛠️ 工具结构

每个工具都实现：

• name: 工具标识符
• description模型描述
• inputSchema参数的 JSON 模式
• handle()： 执行逻辑

______________________________________________________________________

⚠️ 评论

• 远程模式： 确保 OAuth 流中报告的令牌有效。如果到期，点击 关联 再次连接
• 莫多当地： 服务器必须作为本地进程（stdio）运行。 CARTENA_TOKEN 必须在环境变量中设置
• 无需在本地模式下暴露 HTTP 端点

______________________________________________________________________

👩‍💻 开发

要在开发期间在本地运行服务器：

git clone https://github.com/cartena-tecnologia/cartena-mcp.git
cd cartena-mcp
npm install
node server.js

配置指向本地文件的 MCP 客户端 ：

{
  "mcpServers": {
    "cartena": {
      "command": "node",
      "args": ["C:/caminho/para/cartena-mcp/server.js"],
      "env": {
        "CARTENA_TOKEN": "SEU_TOKEN_AQUI"
      }
    }
  }
}