Farina PrimaをあなたのAIエージェントにBETA

エンドポイント

キー不要の公開Streamable HTTPエンドポイント1つで、すべてのMCPクライアントに対応します：

POST https://pandough.app/api/mcp

SSEストリーミングを使用した、HTTP上のステートレスなJSON-RPC 2.0。認証やAPIキーは不要です。

ツール

6個のツールが利用可能です。計算を行う `plan_bake`（データの書き込みは行いません）を除き、すべて読み取り専用です。

Claude Desktopの接続 (stdio)

mcp-remoteブリッジ（HTTPエンドポイントをClaude Desktopのstdioトランスポートにプロキシします）を使用して、`claude_desktop_config.json` にPandoughを追加します：

{
  "mcpServers": {
    "pandough": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://pandough.app/api/mcp"]
    }
  }
}

Claude Desktopを再起動してください。ツールメニューにPandoughのツールが表示されます。

ChatGPTおよびHTTPクライアントの接続

任意のHTTP MCPクライアント（ChatGPTのカスタムコネクター、独自のAIエージェント実行環境など）の接続先をこのエンドポイントに設定し、JSON-RPC 2.0で通信します。利用可能なツールの一覧は以下で取得できます：

POST https://pandough.app/api/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

例：plan_bake

加水率65%のナポリピッツァ4枚分を、ブレンド粉（Caputo Pizzeria 70% ＋ Manitoba Oro 30%）を使用し、実際のキッチンと冷蔵庫の温度、短時間の常温一次発酵（バルク）、一晩の冷蔵低温発酵、そしてイタリア式計算機リンクを含めて計画する場合：

リクエスト

POST https://pandough.app/api/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "plan_bake",
    "arguments": {
      "recipeSlug": "neapolitan-pizza",
      "flourBlend": [
        { "flourSlug": "caputo-pizzeria", "percent": 70 },
        { "flourSlug": "manitoba-oro", "percent": 30 }
      ],
      "hydrationPercent": 65,
      "servings": 4,
      "roomTempCelsius": 22,
      "fridgeTempCelsius": 4,
      "roomTempHours": 4,
      "fridgeTempHours": 20,
      "locale": "it"
    }
  }
}

レスポンス例

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "# Bake Plan\n\n**Total dough:** 1120g\n**Yeast:** 0.4g (0.06%) instant-dry\n\n## Ingredients\n  Pizzeria-ORO: 671g (100%)\n  Water: 436g (65%)\n  Salt: 19g (2.8%)\n  Yeast: 0.4g (0.06%)\n\n## Schedule\n  Warm bulk fermentation: 4h at 22°C\n  Cold fermentation (fridge): 20h at 4°C\n  Final proof: 2h at 22°C\n\n## Warnings\n  - 65% hydration is above Pizzeria-ORO's recommended range (57–64%) — expect a slack, hard-to-handle dough.\n\n## Open in Pandough\nOpen this calculator link to continue editing the bake:\nhttps://pandough.app/it/calculator?recipe=neapolitan-pizza&n=4&w=280&h=65&rt=4&ft=20&y=0.06&blendInline=caputo-pizzeria:70,manitoba-oro:30&source=mcp&aid=1a2b3c4d"
      }
    ]
  }
}

イーストの量、スケジュール、および警告は、Pandough計算機を動かしているものと同じエンジンによって計算されます。これらは小麦粉の特性を考慮しています。`flourSlug` または `flourBlend` を渡すことで、推奨される加水率の範囲が調整され、目標加水率がその範囲から外れている場合は警告が表示されます。室温と冷蔵庫の温度（`roomTempCelsius` / `fridgeTempCelsius`）は、イーストの量と発酵時間に最も大きな影響を与えるため、ユーザーが把握している場合は必ず指定してください。「Open in Pandough」リンクには、`blendInline` によるブレンド情報を含むすべてのパラメータがあらかじめ入力されているため、ユーザーはサインアウトした状態でも、アプリ上で編集を続けることができます。

レート制限

公開エンドポイントには、IPごとのベストエフォートなレート制限が適用されます：

• •30 リクエスト / 分（IPごと）
• •300 リクエスト / 時間（IPごと）

制限を超えると、`Retry-After` ヘッダーとJSON-RPCエラー（コード `-32029`）を含むHTTP 429が返されます。指定された秒数が経過した後にリトライしてください。