API po HTTP
Wywołanie tych samych narzędzi ze skryptu, bez klienta AI pośrodku
Kiedy tego użyć
MCP jest dla asystenta pracującego w twoim imieniu. API po HTTP jest dla zadania w harmonogramie, panelu albo arkusza — dla wszystkiego, co chce liczb o określonej porze, bez żadnego modelu.
Jedno i drugie chodzi na tych samych narzędziach i tym samym kodzie. Liczba z API i ta sama liczba na ekranie nie mogą się różnić, bo każda istnieje w jednej implementacji.
Uwierzytelnienie
Utwórz klucz w Ustawienia → Klucze API i wysyłaj go przy każdym żądaniu:
Authorization: Bearer <klucz>
Działa też X-API-Key: <klucz>. Klucze pokazujemy raz, przy tworzeniu. Daj każdej integracji własny klucz z najwęższym zakresem, który wystarczy do zadania — skrypt raportujący nie ma po co trzymać klucza, którym da się usunąć śledzone pytania.
Dwa endpointy
GET https://app.getscorra.com/api/v1/tools lista narzędzi, które ten klucz może wywołać POST https://app.getscorra.com/api/v1/tools/<nazwa> wywołanie jednego, z argumentami jako JSON
Kody odpowiedzi
| Kod | Znaczenie |
|---|---|
| 400 | Argumenty nie pasują do schematu narzędzia |
| 401 | Brak klucza, klucz nieprawidłowy albo unieważniony |
| 403 | Twój pakiet nie obejmuje dostępu maszynowego |
| 404 | Nie ma takiego narzędzia albo nie ma danych na to, o co pytasz |
| 500 | Awaria po naszej stronie — treść mówi, co się stało |
Limity i koszt
Każde udane wywołanie kosztuje 1 kredyt; nieudane nic nie kosztują. Wywołanie, które uruchamia pracę agenta, płaci też za tę pracę, po tej samej stawce co praca uruchomiona z panelu.