Wprowadź Farina Prima do swojego agentaBETA

Punkt końcowy

Jeden publiczny, bezkluczowy punkt końcowy Streamable HTTP obsługuje każdego klienta MCP:

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

Bezstanowy protokół JSON-RPC 2.0 przez HTTP ze strumieniowaniem SSE. Nie jest wymagana autoryzacja ani klucz API.

Narzędzia

Dostępnych jest 6 narzędzi. Wszystkie działają w trybie tylko do odczytu, z wyjątkiem plan_bake, które wykonuje obliczenia (żadne dane nie są zapisywane).

Połącz Claude Desktop (stdio)

Dodaj Pandough do swojego pliku claude_desktop_config.json, używając mostka mcp-remote (pośredniczy on między punktem końcowym HTTP a transportem stdio programu Claude Desktop):

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

Uruchom ponownie Claude Desktop. Narzędzia Pandough pojawią się w menu narzędzi.

Połącz ChatGPT i klientów HTTP

Skieruj dowolnego klienta HTTP MCP (własne konektory ChatGPT, własne środowisko uruchomieniowe agenta itp.) na punkt końcowy i komunikuj się za pomocą JSON-RPC 2.0. Wyświetl listę dostępnych narzędzi za pomocą:

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

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

Przykład: plan_bake

Zaplanuj cztery pizze neapolitańskie o hydratacji 65% na bazie mieszanki mąk (70% Caputo Pizzeria + 30% Manitoba Oro), uwzględniając rzeczywiste temperatury w kuchni i lodówce piekarza, krótkie wyrastanie w temperaturze pokojowej, nocną fermentację w lodówce oraz link do włoskiego kalkulatora:

Żądanie

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"
    }
  }
}

Przykładowa odpowiedź

{
  "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"
      }
    ]
  }
}

Ilość drożdży, harmonogram i ostrzeżenia są obliczane przez ten sam silnik, który napędza kalkulator Pandough — i uwzględniają one specyfikę mąki: przekazanie parametru flourSlug lub flourBlend dostosowuje zalecany zakres hydratacji i wyświetla ostrzeżenie, gdy docelowa hydratacja wykracza poza ten zakres. Temperatury pokojowe i lodówki (roomTempCelsius / fridgeTempCelsius) są głównym czynnikiem determinującym ilość drożdży i czas fermentacji, więc przekazuj je zawsze, gdy użytkownik je zna. Link „Otwórz w Pandough” uzupełnia wszystkie parametry — w tym mieszankę za pomocą blendInline — dzięki czemu użytkownik może kontynuować edycję w aplikacji, nawet bez zalogowania.

Limity żądań

Publiczny punkt końcowy stosuje limit żądań na adres IP (best-effort):

• •30 żądań / minutę na IP
• •300 żądań / godzinę na IP

Przekroczenie limitu powoduje zwrócenie błędu HTTP 429 z nagłówkiem Retry-After oraz błędu JSON-RPC (kod -32029). Należy wstrzymać wysyłanie i spróbować ponownie po wskazanej liczbie sekund.