Podłączenie Scorry do Claude'a, ChatGPT, Cursora albo n8n

Co daje MCP

Model Context Protocol pozwala klientowi AI — Claude, ChatGPT, Cursorowi, n8n albo czemukolwiek, co nim mówi — czytać twoje dane ze Scorry wprost. Zamiast eksportować CSV i wklejać go do czatu, pytasz tam, gdzie i tak pracujesz:

> Na których pytaniach straciliśmy widoczność w tym miesiącu i jakie źródła za tym stoją?

Klient woła Scorrę, dostaje prawdziwe liczby i z nich odpowiada.

Dostępność

Dostęp maszynowy — MCP, API i klucze API — jest w pakiecie od Growth wzwyż. Działa też w okresie próbnym, więc możesz go sprawdzić przed decyzją.

Każde udane wywołanie narzędzia zużywa 1 kredyt z salda workspace'u - tak samo przez MCP, jak przez API. Jedno pytanie to zwykle kilka wywołań. Wywołania nieudane i niepotwierdzone plany zapisu są darmowe, a przy zerowym saldzie wywołanie dostaje odmowę z wyjaśnieniem; codzienny pomiar działa dalej.

Jeśli twój pakiet tego nie obejmuje, serwer odpowiada kodem 403 i zdaniem, które to mówi, zamiast po cichu nie zadziałać. Połączenie zrobione na wyższym pakiecie przestaje działać po zejściu w dół.

Podłącz w trzech krokach

1. Dodaj serwer

https://app.getscorra.com/api/mcp

W Claude to Ustawienia → Konektory → Dodaj własny konektor. W ChatGPT najpierw włącz Developer mode (Ustawienia → Apps & Connectors → Advanced settings; wymaga płatnego planu), potem Ustawienia → Apps & Connectors → Create, z OAuth jako uwierzytelnianiem. W innych programach szukaj „serwery MCP" albo „własne narzędzia".

W Gemini CLI dodaj serwer z folderu oznaczonego jako zaufany, a potem zaloguj się już w sesji:

gemini mcp add --transport http scorra https://app.getscorra.com/api/mcp

Uruchom gemini, wpisz /mcp auth scorra i zatwierdź połączenie w oknie przeglądarki, które się otworzy. Potem /mcp wylistuje narzędzia Scorry. Chodzi o Gemini CLI, czyli program w terminalu — sama aplikacja Gemini nie ma gdzie dodać serwera.

2. Zaloguj się

Programy obsługujące OAuth otworzą stronę logowania Scorry i poproszą o zgodę na połączenie. Nic nigdzie się nie wkleja — zatwierdzasz, a program zapisuje token.

W programach bez OAuth utwórz klucz API w Ustawienia → Klucze API i wysyłaj go jako Authorization: Bearer <klucz>.

3. O coś zapytaj

> Jaka jest nasza widoczność na ChatGPT przez ostatnie 30 dni i którzy konkurenci są przed > nami?

Jeśli program wylistował narzędzia Scorry, połączenie działa.

Zmiany wymagają drugiego wywołania

Narzędzia odczytu odpowiadają od razu. Narzędzia, które coś zmieniają — dodanie śledzonego pytania, uruchomienie zadania agenta — nigdy nie działają przy pierwszym wywołaniu. Oddają plan tego, co by zrobiły, plus token potwierdzenia, a zmianę wykonuje dopiero drugie wywołanie z tym tokenem.

Token jest podpisany nad dokładnymi danymi wejściowymi, więc potwierdzenie dla usuń pytanie A nie wykona usuń pytanie B, i wygasa po 15 minutach. Twój klient AI pokazuje ci plan i pyta, zanim wyśle drugie wywołanie.

Jeśli nie łączy

• 403 z komunikatem o pakiecie — dostęp maszynowy zaczyna się od Growth.
• 401 — klucz jest zły, unieważniony albo wysłany w złym nagłówku.
• Program nie widzi narzędzi — klucz tylko do odczytu ukrywa narzędzia zapisu i tak ma być. Sprawdź zakresy klucza w Ustawienia → Klucze API.
• Zmiana `AUTH_URL` unieważnia istniejące połączenia OAuth; programy muszą połączyć się ponownie.