マーケット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同様に自動化アシスタントで実現します。
- 無料でグリーンマーケットに参加、またはRoastnetコンソールを開く。
- Connect agentでAIアシスタント用トークン発行。
- 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で公開。キー取得は不要です。
買い手の目に届くロット管理を。
無料でグリーンマーケットに登録し、キーを作成して今日中にシステム連携を始めましょう。