CarbonMeld MCPサーバー
AIアシスタントでカーボンクレジットデータを利用:プレミアムアカウントでのサインイン(またはAPIキー)でアシスタントやMCPクライアントを接続し、プロジェクト検索、評価、CORSIAレジストリラベル、バイヤープロフィールを利用できます。
できること
Model Context Protocol(MCP)を通じて、アシスタントがCarbonMeldのプロジェクト記録とレジストリ情報を参照できます。MCP処理では言語モデルを動かしません。返されたデータはお使いのアシスタントが解釈します。CarbonMeldの記録を読み取り、クレジットの発行・購入・移転は行いません。
ツール
search_projects
入力: query、registry、country、methodology、sector、scoring_sector、developer、status、min_score、claim、sort、limit(1~25、既定値10)、offset
語句で検索し(すべての語句がプロジェクト名、登録コード、国、方法論、分野のいずれかに含まれること)、基準、国、方法論、分野、評価分野(評価時の分野で、ランキングの分類)、開発者、分析状況、スコア、主張タグで絞り込み、評価または名前で並べ替えます。該当件数の合計とその1ページ分(続きがあるときはnext_offset)を返します:識別子、国とそのISOコード、方法論、分野、開発者、評価とその状況・日付・手法のバージョン、登録状況、主張タグ、プロジェクトURL。
get_project
入力: id(必須)、lang・sections(任意)
スラッグまたは登録コードで取得できる全記録。プロジェクトページのURLと文書のリンク(文書に専用ページがある場合はそのページも)を付けます。評価は方法論 v3 の文書に基づく評価で、その区分と証拠の網羅度を付けます。v2.2 のスコアを維持するページはそのスコアを明示して返し、数値のないページはその理由を返します。記録には不利な事実、ビンテージ、主張も含まれ、スコアのセクションには v3 評価の詳細(各評価軸の値と、適用された各ルールとその出典)が加わります。v2.2 の分析の項目(評価軸のスコア、リスク指標、改善点)は、v2.2 の分析によるデータとして記録に残ります。v3 で評価されたページには表示されません。方法論 v3 で読んだページはレッドフラグを返さず、v2.2 のスコアを維持するページはレッドフラグを v2.2 と明示して返します。記録以外にページが示す内容(ページ上のお知らせ、「この分析はどう行われたか」、類似プロジェクト、PDFレポートのアドレス)も付けます。lang(en、zh、ja)でその言語の翻訳を、sectionsで指定した部分だけを返します。プレミアムの詳細は共通のプロジェクト枠を使用します。
get_projects
入力: ids(必須;1~10件のスラッグまたは登録コード)、lang・sections(任意)
1回の呼び出しで複数のプロジェクト記録を取得します:各idにget_projectと同じ記録を指定順で返し、失敗したidにはそのid自身のエラーを付けます。返された各記録は、get_projectとまったく同じく共通のプロジェクト枠を使用します。呼び出しのリクエスト上限を超えたidは、再試行可能な状態で開かれずに返されます(枠は使いません)——そのidだけ再度お試しください。
check_offer
入力: text(必須)、vintage・quantity・seller(任意)
貼り付けたオファーを登録、ビンテージ、数量、主張、開発者の記録と照合します。特定のシリアル番号の所有権や利用可能性は確認しません。
corsia_supply
入力: lang(任意)
サイトに表示されるとおりの、レジストリ別・フェーズ別のCORSIAレジストリラベル、First Phaseの高評価プロジェクト、レジストリごとの平均評価(いずれもプロジェクトの現在の評価から)。残高は全ビンテージの未償却ユニットであり、CORSIA適格ユニットではありません。
get_buyer
入力: name(必須、会社名またはバイヤースラッグ)、lang・limit(1~50、既定値25)・offset(任意)
CarbonMeldのページの内容どおりの組織の公開償却記録:トン数、償却回数、償却したものの品質、プロジェクト(それぞれ償却トン数とプロジェクトの現在の評価)、最近の償却。償却の受益者が購入者とは限りません。名前が曖昧な場合は確認が必要です。
get_methodology
入力: code(必須)、lang(任意)
CarbonMeldの方法論ページの内容どおりに1つの方法論を返します:出典付きの識別カード、方法論 v3 がこの種類のプロジェクトをどう読むか(v3でも変わらないv2.2のルール、変更されたルールとその変更後のv3のルール、v2.2の当時のルールへのリンク)、バージョン履歴と移行、そのプロジェクト(v3 評価のランキングまたは一覧)、ページのURL。
get_ranking
入力: dimension(必須:sector、country、standard、methodology)、value・lang(任意)
サイトに表示されるとおりのランキング:ある軸のランキング一覧とその件数・平均、または1つのランキングの評価順のプロジェクト(評価済み5件以上)とページのURL。分野別ランキングは、評価時の分野でプロジェクトをまとめます。
get_standard
入力: code(必須)、lang(任意)
CarbonMeldの基準ページの内容どおりに1つの基準を返します:出典付きの識別カード、方法論 v3 がこの基準のプロジェクトをどう読むか(v3でも変わらないv2.2のプログラム規則、変更されたルールとその変更後のv3のルール、v2.2の当時のルールへのリンク)、その基準が発行する方法論とプロジェクトが使う方法論、そのプロジェクト(v3 評価のランキングまたは一覧)、ページのURL。
get_developer
入力: name(必須、開発者名またはスラッグ)、lang・limit(1~50、既定値25)・offset(任意)
CarbonMeldの開発者ページの内容どおりに1つのプロジェクト開発者を返します:プロジェクト数、方法論 v3 の評価があるプロジェクト数、登録状況が却下・取り下げ・終了・停止中・発行拒否のプロジェクト数、基準と国、ページの順のプロジェクト。各プロジェクトには登録コード、国、登録状況、評価または分析状況、プロジェクトURLを付けます。評価は一覧のとおりで、方法論 v3 の評価とその区分、v2.2 と明示した v2.2 のスコア、または「評価には時期尚早」/「まだ評価できません」/「適用される公開の評点はまだありません」/「評価は表示していません」です。再評価中は暫定と表示します。ページのURLも付けます。会社単位の評価はありません。名前が曖昧な場合は確認が必要です。
ccp_tracker
入力: status、program、methodology、lang(すべて任意)
サイトに表示されるとおりのICVCM CCPトラッカー:インテグリティ評議会による方法論の評価とその状況・状況ごとの件数、各評価について同じ方法論コードでCarbonMeldが追跡しているそのプログラムのプロジェクト数(全バージョン。CCPラベル付きクレジットの数ではありません)とランキング、表の出典と取得日。
my_portfolio
入力: なし
ページに表示されるとおりのご自身のポートフォリオ(マイポートフォリオ):保存したプロジェクトと、それぞれの評価(一覧のとおり:方法論 v3 の評価とその区分、v2.2 と明示した v2.2 のスコア、または「評価には時期尚早」/「まだ評価できません」/「適用される公開の評点はまだありません」/「評価は表示していません」。再評価中は暫定と表示)、分析状況、登録状況、ビンテージ、出品数、分析日。方法論 v3 で読んだプロジェクトは不利な事実、v2.2 のスコアを維持するプロジェクトはレッドフラグ(v2.2 と明示)。評価軸の値は、評価済みのすべてのプロジェクトが同じ方法論バージョンのときだけ。v3 評価の平均、別々に数える2つの合計(方法論 v3 で読んだプロジェクトの不利な事実の合計と、v2.2 のスコアを維持するプロジェクトのレッドフラグの合計)、今週の残り変更回数、これらのプロジェクトの過去30日間の変更通知。読み取り専用です:プロジェクトの保存と削除はサイトで行います。1日のプロジェクト枠は使いません。
what_changed
入力: view(all、notices、labels)、lang、limit(1~100、既定値50)、offset(すべて任意)
CarbonMeld が記録した直近30日間の変化:ルール策定機関の公式通知(ICVCM、Verra、Gold Standard、SBTi など。発行元、タイトル、リンク、日付)と、プロジェクトのレジストリラベルの付与・削除(各プロジェクトページのURL付き)、および期間全体でラベル変更の種類ごとのプロジェクト数。
get_method
入力: section・rule・dimension(一度に1つ、すべて任意)、lang・limit(1~50、既定値25)・offset(任意)
サイトに表示されるとおりのCarbonMeldの評価方法(/methodology/):方法論 v3、文書に基づく評価。引数なしでは、ページの各セクション、方法論のバージョン、4つの評価軸とその重み、アーカイブされたv2.2のルールのアドレス。あるセクション:ページ上の文章と、そこに記載されたルールのID、ルールカードごとに1行。ID(A-START、Q-FNRB-ABOVE)またはルールカードのキーで1つのルール:名称、内容、各効果とその幅、適用開始時期、出典と出典の原文。v2.2のID(CM-…)は、v2.2でのそのルールと、v3での扱い(同じ、変更(変更後のv3のルール付き)、削除)を返します。ある評価軸(additionality、quantification、permanence、claim_safety、overall):その評価軸に作用するルールをページ単位で(limit・offset、続きがあるときはnext_offset)。方法論 v3 にはcriterionはありません。
search_articles
入力: query・tag・from・to(YYYY-MM-DD)・sort(newest、oldest)・lang・limit(1~50、既定値10)・offset(すべて任意)
サイトの記事インデックスのとおりに、CarbonMeldの英語・中国語・日本語の記事を検索します:語句で(すべての語句がタイトル、要約、トピックのいずれかに含まれること)、トピックで(サイトのそのトピックのページの記事)、日付で。該当件数の合計とその1ページ分を最新順または古い順で返します(続きがあるときはnext_offset):タイトル、日付、要約、トピック、カテゴリー、URL。該当がない場合は空のリストを返し、エラーにはなりません。
search_projectsのclaim指定値:corsia、corsia_first、ccp、ccp_meth、removal、article6。ラベルはCarbonMeldが保有する記録を反映します。
サインインで接続する
Claude、ChatGPT、Claude Code、Cursor、VS Code、Microsoft 365 Copilotのエージェントは、サインインでCarbonMeldに接続できます。キーを貼り付ける必要はありません。CarbonMeldのページで接続を承認すると、アシスタントはAPIと同じ1日あたりの上限の範囲でプレミアムのデータを読み取れます。読み取りのみで、変更や支払いはできません。接続したすべてのアシスタントは、1日あたりのリクエスト上限を共有します。
サーバーURL
https://carbonmeld.com/api/v1/mcp 公式のMCP Registryでの名前:com.carbonmeld/carbonmeld。
Claude(Web版、デスクトップ・モバイルアプリ)
- 「Customize → Connectors」(claude.ai/customize/connectors)を開き、「+ Add」、次に「Add custom connector」を選びます。
- 名前:CarbonMeld。サーバーURL:https://carbonmeld.com/api/v1/mcp。「Continue」を選びます。
- 認証:「Sign in now」(または「Sign in when needed」)。OAuth client:「Register automatically」。
- 「Add」を選ぶとCarbonMeldのページが開きます。メールのリンクでサインインし(同じブラウザで開いてください)、承認します。
- 会話の中で「+ → Connectors」からCarbonMeldを有効にします。
代わりにAPIキーを使う場合:手順3で「No sign in」を選び、「Request headers」にAuthorizationを追加して、値に Bearer とご自身のキーを続けて入力します。
TeamプランとEnterpriseプラン:Claudeの組織のOwnerが「Organization settings → Connectors → Add → Custom → Web」でコネクタを追加し、各メンバーは自分のアカウントでサインインして接続します。CarbonMeldはClaudeのコネクタディレクトリにも掲載されています。
ChatGPT
- chatgpt.com/plugins を開きます。
- 「+」ボタンを選び、「Add custom MCP server」を選びます。
- 名前(CarbonMeld)と説明を入力します。
- 「Connection」にサーバーURL https://carbonmeld.com/api/v1/mcp を入力します。
- 認証方式にOAuthを選びます。ChatGPTが自動でCarbonMeldに登録するため、クライアントIDやクライアントシークレットは不要です。リスクの警告を確認し、「I understand and want to continue」を選びます。
- 「Create as a plugin」を選び、表示されるツールを確認してインストールします。
- 開いたCarbonMeldのページでサインインし、承認します。新しい会話で @ を入力し、CarbonMeldを選びます。
カスタムMCPサーバーの追加と利用には、アカウントとワークスペースのポリシーが適用されます。
Claude Code
claude mcp add --transport http carbonmeld https://carbonmeld.com/api/v1/mcp サーバーを追加したら、Claude Codeで /mcp を実行して認証を選ぶか、シェルで claude mcp login carbonmeld を実行します。ブラウザでCarbonMeldのページが開くので、サインインして承認します。承認後にブラウザが接続エラーを表示した場合は、アドレスバーの完全なアドレスを、Claude Codeが表示する入力欄に貼り付けてください。--scope user を付けると、すべてのコードプロジェクトでこのサーバーを使えます。
代わりにAPIキーを使う場合は、ヘッダーを追加します。キーをコミットせずにコードプロジェクトで設定を共有するには、環境変数 CARBONMELD_API_KEY からキーを読み込む .mcp.json を使います:
claude mcp add --transport http carbonmeld https://carbonmeld.com/api/v1/mcp \
--header "Authorization: Bearer cmk_YOUR_KEY_HERE" {
"mcpServers": {
"carbonmeld": {
"type": "http",
"url": "https://carbonmeld.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer ${CARBONMELD_API_KEY}"
}
}
}
} Cursor
{
"mcpServers": {
"carbonmeld": {
"url": "https://carbonmeld.com/api/v1/mcp"
}
}
} ~/.cursor/mcp.json(すべてのコードプロジェクト)または .cursor/mcp.json(1つのコードプロジェクト)にサーバーを追加します。Cursorがサーバーへのサインインを求めます。CarbonMeldのページが開いたらサインインし、承認します。CursorのWebアプリとCursor AgentsもCarbonMeldにサインインできます。
代わりにAPIキーを使う場合は、ヘッダーを追加し、Cursorを起動する環境で CARBONMELD_API_KEY を設定します:
{
"mcpServers": {
"carbonmeld": {
"url": "https://carbonmeld.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:CARBONMELD_API_KEY}"
}
}
}
} VS Code(GitHub Copilot)
- コマンドパレットから「MCP: Add Server」を実行します。
- 「HTTP (HTTP or Server-Sent Events)」を選び、https://carbonmeld.com/api/v1/mcp を入力します。
- サーバーID carbonmeld を入力し、「Global」を選びます。
- サーバーが起動すると、VS Codeがサインインを求めます。ブラウザでCarbonMeldのページが開くので、サインインして承認します。
これで書き込まれるエントリー(ポータブル形式のファイル ~/.copilot/mcp-config.json):
{
"mcpServers": {
"carbonmeld": {
"type": "http",
"url": "https://carbonmeld.com/api/v1/mcp"
}
}
} 代わりにAPIキーを使う場合は、環境からキーを読み込むヘッダーを追加し(ポータブル形式のファイルは環境変数を読み込み、入力プロンプトには対応しません)、VS Codeを起動する環境で CARBONMELD_API_KEY を設定します。キーをチャットに貼り付けたり、コードプロジェクトにコミットしたりしないでください。
{
"mcpServers": {
"carbonmeld": {
"type": "http",
"url": "https://carbonmeld.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer ${CARBONMELD_API_KEY}"
}
}
}
} Microsoft 365 Copilot(宣言型エージェント)
Microsoft 365 Copilotにはサーバーを追加する欄がありません。CarbonMeldは、Microsoft 365 Agents Toolkit(VS Code拡張機能、バージョン6.12.0以降)で作成する宣言型エージェントのプラグインとして利用できます。Microsoft 365アカウントでカスタムアプリのアップロードとCopilotへのアクセスが有効になっている必要があります。有効でない場合は管理者に確認してください。この方法ではAPIキーは使えません。
- VS CodeでMicrosoft 365 Agents Toolkitを開き、「Create a New Agent/App」→「Declarative Agent」を選びます。
- 「Add an Action」→「Start with an MCP Server」を選び、https://carbonmeld.com/api/v1/mcp を入力します。
- 認証の種類:「OAuth (with dynamic registration)」。クライアントIDやクライアントシークレットは不要です。
- エージェントの保存場所と名前を選びます。
- 「Accounts」でMicrosoft 365にサインインし、「Lifecycle」で「Provision」を選びます。
- m365.cloud.microsoft/chat を開き、「Agents」からエージェントを選んでプロジェクトについて質問します。求められたらエージェントへのサインインを選びます。CarbonMeldのページが開くので、サインインして承認します。
Le Chat(Mistral):まだ対応していません。
アシスタントの接続を解除するには、アカウントページを開いてください。「接続中のアシスタント」に各アシスタントと「接続を解除」ボタンが表示されます。解除はすぐに反映され、APIキーには影響しません。
またはAPIキーで接続する
リモートサーバーURLと固定のAuthorizationヘッダーを設定できるMCPクライアントであれば、サインインの代わりにAPIキーを使えます。クライアントの画面はそれぞれ異なります。ヘッダーの設定場所は、上の各クライアントの説明にあります。
- 有効なプレミアムのアクセスがあれば、アカウントページからキーを発行できます。
- 以下のリモートサーバーURLを設定し、自分のキーを含むAuthorizationヘッダーを追加します。
- 接続してツール一覧を取得し、まずプロジェクトを検索してから完全な記録を開くようアシスタントに依頼します。
接続設定
https://carbonmeld.com/api/v1/mcp
Authorization: Bearer cmk_YOUR_KEY_HERE キーを共有ファイルに入れないでください。上のJSON設定は環境変数 CARBONMELD_API_KEY からキーを読み込みます。キーをチャットに貼り付けたり、コードプロジェクトにコミットしたりしないでください。
通信方式はHTTP POSTによるJSON-RPC 2.0で、JSONを返します。サーバーURLをGETで開くと405になります。Webページではありません。
プロトコルバージョン: 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"}' Code Mode で CarbonMeld を使う
Cloudflare の Code Mode(Agents SDK)など、一部の MCP クライアントは、サーバーのツールを型付きの TypeScript API に変換し、モデルがツールを1件ずつ呼ぶ代わりにツールを呼び出すコードを書けるようにします。CarbonMeld はすべてのツールに出力スキーマを宣言し、成功した各結果を JSON テキストに加えて structuredContent としても返すため、これらのクライアントは呼び出しごとに正確な型を得られます。
ツールのスキーマと OpenAPI ドキュメントから生成した TypeScript 型宣言(.d.ts): https://carbonmeld.com/api/v1/carbonmeld.d.ts
例:ケニアで文書に基づく評価が5以上のクックストーブ(cookstoves)プロジェクトを検索し、上位3件を1回のバッチで取得して、それぞれの評価、区分、証拠の網羅度、評価を上げたルールと下げたルールの数、不利な事実を一覧表示します。
// Cookstove projects in Kenya with a document-based rating of 5 or more, best first — search (free), then open the top 3
const found = await carbonmeld.search_projects({ sector: "cookstoves", country: "KE", min_score: 5, sort: "rating_desc", limit: 10 });
const batch = await carbonmeld.get_projects({ ids: found.results.slice(0, 3).map((p) => p.id), sections: ["score"] });
// each project not yet opened today counts 1 of the daily 30 — batch.quota says what is left
for (const item of batch.results) {
if (!item.ok) continue; // item.error says why this id gave no record (retryable: ask again for it)
const r = item.project.carbonmeld_rating, d = item.project.doc_rating;
// the rating, its band and evidence coverage; how many rules raised / lowered it; its negative facts (often none)
console.log(item.project.project_name, r.rating, r.rating_band, r.evidence_coverage, d.moves, d.negative);
} 利用枠について:get_projects が返す各プロジェクト記録は、get_project と同じく日次プロジェクト枠の1件を使います——10件のバッチなら最大10件分です。その日にまだ開いていないプロジェクトは1日の枠(プレミアム30件、Pro 300件)の1件を使うため、まず検索し(search_projects は無料)、ユーザーが必要とするものだけを開いてください。その日に開封済み、所有または付与済みのプロジェクトは0件扱いです。search_projects と各ページツールはこの枠を使いません。すべてのツール呼び出しは日次リクエスト上限にカウントされます。
上限とフェアユース
- 300 リクエスト/日/キーが標準上限です。RESTとMCPで共有します。
- 30 件の異なるプレミアムプロジェクト/日を、サイト、PDFレポート、REST、MCPで共有します。同日に同じプロジェクトを再表示しても1件です。ポートフォリオ内および個別にアンロックされたプロジェクトは対象外です。公開記録のみの取得もこの枠を使いません。
- Pro の場合:1キーあたり1日 1,000 リクエスト、1日 300 件の異なるプロジェクト。その他は上記と同じです。
- 20 回のオファーチェック/日/アカウント。サイトのオファーチェックと共有します。
日次カウンターは00:00 UTCにリセットされます。IPごとに毎分120リクエストのバースト上限もあります。一覧と統計の取得はリクエスト上限に含まれますが、プレミアムプロジェクト枠は使いません。
get_projectとget_projectsはREST APIと同じプレミアムプロジェクト枠を使います(get_projectsは返した記録ごとに1件分)。ツールの呼び出しは1日のリクエスト上限に含まれます。接続、ツール一覧の取得などのプロトコルメッセージは含まれません(別に、はるかに高い上限があります)。
認証や頻度のエラーはHTTPステータスで返ります。HTTPが成功しても、ツール結果にisError: trueが含まれる場合があります。結果を確認してください。一時的なデータエラーは否定的な判定ではありません。後で再試行してください。
データとプライバシー
クライアントは貼り付けたオファー文などのツール引数をCarbonMeldに送信します。返された記録はクライアントに渡り、お使いのアシスタントが推論します。必要な情報だけを共有し、クライアントのデータ設定を確認してください。CarbonMeldはプレミアム機能の利用とプレミアムプロジェクトへのアクセスを記録します。
REST APIと同じキー
HTTPの直接リクエスト、一覧パラメーター、エラーコードはRESTガイドをご覧ください。
APIガイド