RoastnetRoastnet

マーケットAPIとMCP

在庫管理やAIをグリーンコーヒー市場へ接続。

Roastnet上のグリーンコーヒー在庫と自社システムを同期し、新規注文やサンプルリクエストに迅速対応。AIアシスタントも同様に利用可能です。

REST API

一つのキーで販売業務を管理。

Roastnetコンソールで発行したキーをBearerトークンとして送信。APIはロット、注文、サンプル、オファーやイベントフィードをカバーし、ウェブフックを活用して変化を即時検知できます。

curl https://network.roastnet.ai/api/market/v1/lots \
  -H "Authorization: Bearer rnk_YOUR_KEY"
  • 01自社管理番号でロットの一覧、同期、更新、取り下げが可能。
  • 02注文の確認、辞退、出荷完了・配送完了の管理対応。
  • 03サンプルリクエスト確認と発送済み登録が可能。
  • 04キー毎毎分120リクエストまで対応。429レスポンスで再試行時刻通知。

AIエージェント(MCP)

AIアシスタントを接続。

Roastnetはグリーンコーヒー市場向けModel Context Protocolサーバーを提供。各種MCPクライアントを接続し、市場閲覧やロット管理、注文・サンプル管理をAPI同様に自動化アシスタントで実現します。

  1. 無料でグリーンマーケットに参加、またはRoastnetコンソールを開く。
  2. Connect agentでAIアシスタント用トークン発行。
  3. MCPクライアントに下記サーバーを登録し、トークンを入力。

MCPクライアント設定(JSON)

{
  "mcpServers": {
    "roastnet-market": {
      "type": "http",
      "url": "https://network.roastnet.ai/api/network/fitter-mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

コマンドラインクライアント利用の場合

claude mcp add --transport http roastnet-market \
  https://network.roastnet.ai/api/network/fitter-mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

YOUR_TOKENをConnect agentで発行のトークンと差し替えてください。トークンはいつでも同画面で失効可能です。

機械向けに設計

設計段階から自動発見可能。

エージェントやクローラーが、/.well-known/mcp.jsonのMCPサーバーカードや/llms.txtの概要、また本ページのOpenAPIドキュメントへのリンクを認識できます。

ご質問

よくいただくご質問

Market APIは誰が利用できますか?
Roastnetグリーンコーヒー市場で販売するインポーター、ロースター、輸出事業者など、アカウントとキー発行済みの事業者様がご利用いただけます。
認証方法はどうなっていますか?
REST APIはBearerトークンでAPIキー認証。MCPはConnect agentで発行したトークンをBearerトークンとして使用します。
OpenAPI仕様書はどこで入手できますか?
network.roastnet.ai/api/market/v1/openapi.jsonで公開。キー取得は不要です。

Market API利用規約

買い手の目に届くロット管理を。

無料でグリーンマーケットに登録し、キーを作成して今日中にシステム連携を始めましょう。