AI导哈

MCP服务器

Cartena MCP Server是一个实现MCP协议的服务器，用于将Cartena的工具集成到兼容的AI客户端中，如Claude。

  • by cartena-tecnologia
  • JavaScript
  • 混合部署
  • 更新于
在 GitHub 查看 cartena-tecnologia/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. 点击 添加自定义连接器 并报告URL ：
    https://mcp.cartena.com.br/mcp
  4. 确认保存

2. 链接您的帐户：

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

  2. 将打开一个请求权限的窗口

    管理您的访问权限： 文件夹 → 安全

  3. 点击 允许访问

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

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

通过文件配置（ 兼容的 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"
      }
    }
  }
}

相关 MCP