跳转到主要内容
CarbonMeld CarbonMeld 碳观测站
工具
ZH
高级版

CarbonMeld MCP 服务器

更新日期:

使用高级版 API 密钥连接 MCP 客户端:项目搜索、完整记录、报价核查、CORSIA 供应与买家概况。

打开账户栏 · 通行证详情与价格

功能概览

通过模型上下文协议(MCP),让您的助手读取 CarbonMeld 项目记录和登记信息。MCP 处理程序不运行语言模型;返回数据由您自己的助手解读。它读取 CarbonMeld 记录,不签发、购买或转移碳信用。

质量评分方法

五个工具

search_projects

输入: query、registry、min_score、claim、limit(1–25;默认10)

按项目名称中的词语或登记编号搜索,可按标准、评分和声明标签筛选。返回标识符、国家、评分、登记状态、声明标签和项目链接。

get_project

输入: id(必填)

按 slug 或登记编号获取已有完整项目记录,包括分析、风险提示、年份和声明。高级版详情消耗共享的项目额度。

check_offer

输入: text(必填);vintage、quantity、seller(可选)

将粘贴的报价文本与记录中的登记、年份、数量、声明和开发商信息比较,不确认特定序列号的所有权或可用性。

corsia_supply

输入: 无

基于登记标签,按登记机构和阶段返回 CORSIA 供应数据,以及评分最高的第一阶段项目。

get_buyer

输入: name(必填;公司名称或买家 slug)

组织的公开注销记录:吨数、项目及其质量。注销受益方不一定是购买方;名称有歧义时需进一步确认。

search_projects 的 claim 可选值:corsia、corsia_first、ccp、ccp_meth、removal、article6。标签反映 CarbonMeld 持有的记录。

连接客户端

请使用支持设置远程服务器 URL 和静态 Authorization 请求头的 MCP 客户端。各客户端界面不同;本指南不承诺与特定应用兼容。

  1. 持有效通行证,在账户栏生成密钥。
  2. 设置下方远程服务器 URL,并添加包含您自己密钥的 Authorization 请求头。
  3. 连接后让客户端列出工具,再让助手先搜索项目,然后打开其完整记录。

连接设置

https://carbonmeld.com/api/v1/mcp
Authorization: Bearer cmk_YOUR_KEY_HERE

传输方式:通过 HTTP POST 发送 JSON-RPC 2.0,返回 JSON。使用 GET 打开服务器 URL 会返回405;该地址不是网页。

协议版本: 2025-06-18

示例:列出工具

curl 'https://carbonmeld.com/api/v1/mcp' \
  -H 'Authorization: Bearer cmk_YOUR_KEY_HERE' \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

额度与合理使用

  • 300 次请求/天/密钥,为默认上限,由 REST 与 MCP 共享。
  • 30 个不同高级版项目/天,由网站、PDF 报告、REST 与 MCP 共享。同一天重复打开同一项目只计一次。投资组合中的项目及为您解锁的项目不占此额度;仅返回公开记录也不消耗项目额度。
  • 20 次报价核查/天/账户,与网站报价核查共享。

每日计数在 UTC 00:00 重置。另外,每个 IP 每分钟最多120次请求。列表和统计请求计入请求次数,但不消耗高级版项目额度。

get_project 与 REST API 共享高级版项目额度。MCP 连接及工具请求也受 API 请求次数限制。

认证和频率错误通过 HTTP 状态码返回。即使 HTTP 请求成功,工具结果也可能包含 isError: true,请检查结果内容。临时数据错误不是负面结论,请稍后重试。

数据与隐私

客户端会将工具参数(包括您粘贴的报价文本)发送给 CarbonMeld,返回记录则交给客户端,由您的助手进行推理。请仅提供核查所需信息,并检查客户端的数据设置。CarbonMeld 记录通行证功能使用和高级版项目访问。

隐私政策 · 使用条款

与 REST API 使用相同密钥

直接 HTTP 请求、列表参数及错误码请参阅 REST 指南。

API 指南