fullmetrixDocs

Serwer MCP

Połącz Claude, ChatGPT lub innego zgodnego asystenta AI z danymi Fullmetrix i odpytuj swój sklep z asystenta, którego już używasz.

Serwer MCP Fullmetrix pozwala Twojemu ulubionemu asystentowi AI, takiemu jak Claude lub ChatGPT, czytać Twoje dane Fullmetrix. Po połączeniu zadajesz pytania w Claude lub ChatGPT, na przykład "Które produkty sprzedawały się najlepiej we wrześniu?", a asystent pobiera odpowiedź z Twoich liczb.

MCP to skrót od Model Context Protocol. To otwarty standard, który określa, jak asystent AI podłącza się do źródła danych. Każdy asystent zgodny z MCP może więc połączyć się z Fullmetrix w ten sam sposób.

Dostęp jest tylko do odczytu. Asystent może czytać Twoje dane, ale nie może niczego zmienić we Fullmetrix, w Twoim sklepie ani na Twoich kontach reklamowych.

Wolisz zostać we Fullmetrix?

Asystent AI wbudowany we Fullmetrix wykonuje to samo zadanie bez opuszczania aplikacji i dodaje wykresy oraz raporty do udostępniania. Serwer MCP jest dla sytuacji, gdy chcesz pracować z asystenta, którego już używasz.

Adres serwera

Każdy klient używa tego samego adresu.

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

Serwer działa przez HTTP, w trybie, który klienci MCP nazywają "Streamable HTTP". Połączyć się można na dwa sposoby.

  • Za pomocą konta Fullmetrix. Klient kieruje Cię na stronę Fullmetrix, na której autoryzujesz dostęp. To zalecana metoda, bez klucza do skopiowania.
  • Za pomocą klucza API, dla klientów, które nie mogą otworzyć strony logowania. Zobacz niżej.

Zanim zaczniesz

Potrzebujesz konta Fullmetrix z co najmniej jedną organizacją, której sklep jest podłączony i zsynchronizowany. Asystent czyta dane Twoich organizacji, więc musi mieć co czytać.

Dostęp MCP wchodzi w skład Twojej subskrypcji Fullmetrix, bez dodatkowych kosztów. Korzystanie z Claude lub ChatGPT jest nadal rozliczane przez ich twórców zgodnie z Twoim planem u nich.

Połącz Claude

Otwórz wizytówkę Fullmetrix

Fullmetrix Analytics jest opublikowany w katalogu Claude. Otwórz jego stronę albo poszukaj Fullmetrix w Claude, w sekcji konektorów w ustawieniach.

Dodaj konektor

Kliknij przycisk dodawania. Claude otworzy stronę Fullmetrix. Zaloguj się w razie potrzeby i zatwierdź dostęp zgodnie z opisem w następnej sekcji.

Zadaj pytanie

W nowej rozmowie sprawdź, czy konektor Fullmetrix jest włączony, i zadaj pytanie.

Zależnie od planu Claude dodawanie konektorów może być zarezerwowane dla wybranych subskrypcji albo dla administratora przestrzeni zespołu. Adres https://app.fullmetrix.com/api/mcp nadal działa jako konektor niestandardowy, jeśli wolisz dodać go ręcznie.

Połącz ChatGPT

ChatGPT akceptuje serwery MCP jako własną aplikację, zwaną też konektorem.

Otwórz ustawienia aplikacji

W ChatGPT otwórz ustawienia, a potem sekcję aplikacji i konektorów. W zależności od planu dodanie własnej aplikacji wymaga najpierw włączenia trybu programisty w ustawieniach zaawansowanych.

Utwórz aplikację

Utwórz nową aplikację. Nadaj jej nazwę Fullmetrix, wklej adres https://app.fullmetrix.com/api/mcp i wybierz uwierzytelnianie OAuth. Potwierdź.

Autoryzuj dostęp

ChatGPT otworzy stronę Fullmetrix. W razie potrzeby zaloguj się, a potem autoryzuj dostęp.

Używaj Fullmetrix w rozmowie

W rozmowie dodaj aplikację Fullmetrix z menu narzędzi, a potem zadaj pytanie.

Menu ChatGPT zmieniają się często. Jeśli nie możesz znaleźć opcji, wyszukaj "custom connector" lub "MCP" w pomocy ChatGPT.

Połącz innego klienta MCP

Cursor, Visual Studio Code, Windsurf i większość narzędzi zgodnych z MCP konfiguruje się za pomocą adresu serwera. W pliku konfiguracji MCP swojego narzędzia zadeklaruj serwer zdalny w ten sposób.

{
  "mcpServers": {
    "fullmetrix": {
      "url": "https://app.fullmetrix.com/api/mcp"
    }
  }
}

Dokładne nazwy kluczy mogą się różnić w zależności od narzędzia. Sprawdź jego dokumentację. Przy pierwszym użyciu narzędzie otwiera w przeglądarce stronę autoryzacji Fullmetrix.

Połącz za pomocą klucza API

Jeśli Twój klient nie obsługuje logowania kontem, użyj klucza API. Utwórz go w Ustawieniach, na karcie Klucze API, zgodnie z opisem w Publiczne API. Potem dodaj go do nagłówka Authorization żądań klienta.

{
  "mcpServers": {
    "fullmetrix": {
      "url": "https://app.fullmetrix.com/api/mcp",
      "headers": {
        "Authorization": "Bearer fmx_YOUR_KEY"
      }
    }
  }
}

Klucz daje dostęp do jednej organizacji, tej, w której go utworzono. Logowanie kontem daje dostęp do wszystkich Twoich organizacji.

Strona autoryzacji

Gdy klient łączy się za pomocą Twojego konta, Fullmetrix pokazuje stronę Connect an external application. Jeśli nie jesteś zalogowany we Fullmetrix, najpierw pojawia się strona logowania.

Strona opisuje, o co prosi aplikacja.

  • Read analytics data, czyli podgląd Twoich sklepów, klientów, produktów, zamówień, kampanii, kosztów i danych podłączonych usług.
  • Access authorized organizations. Dostępne będą tylko organizacje, do których masz już dostęp we Fullmetrix.

Informacja przypomina, że dostęp jest tylko do odczytu. Kliknij Authorize access, aby potwierdzić, albo Deny, aby anulować. Następnie automatycznie wracasz do swojego klienta.

Jeśli pojawi się komunikat "The authorization could not be completed. Please try again.", rozpocznij połączenie od nowa z poziomu swojego klienta.

Które organizacje są dostępne

Logowanie kontem otwiera dostęp do organizacji, które widzisz we Fullmetrix. Są to organizacje Twojej firmy, jeśli jesteś administratorem, oraz te, do których dostęp nadał Ci administrator. Asystent nigdy nie widzi organizacji, której Ty sam nie widzisz. Aby zarządzać tymi dostępami, zobacz Zespół i role.

Jeśli masz kilka organizacji, wskaż w pytaniu sklep lub organizację. W przeciwnym razie asystent odpytuje pierwszą z listy.

Udostępniane narzędzia

Klient MCP wykrywa narzędzia, czyli działania, które może wywołać. Fullmetrix udostępnia trzy, wszystkie tylko do odczytu.

NarzędzieCo robi
describe_dataOpisuje dostępne dane i usługi podłączone do Twoich organizacji. Asystent wywołuje je przed pierwszym pytaniem
query_dataCzyta dane Twojego sklepu we Fullmetrix, takie jak zamówienia, pozycje zamówień, produkty, warianty, kategorie, klienci, kontakty, koszyki, kody rabatowe, zwroty, subskrypcje i przeglądanie witryny przez odwiedzających. Czyta też dane konfiguracji Twojego konta Fullmetrix
platform_queryOdpytuje podłączoną usługę spośród Google Ads, Meta Ads, TikTok Ads, ChatGPT Ads, Google Analytics 4, Search Console i Crisp. Jeśli masz kilka kont w tej samej usłudze, odpytuje je wszystkie, chyba że wskażesz jedno

Nie wywołujesz tych narzędzi samodzielnie. Zadajesz pytanie zwykłym językiem, a asystent wybiera narzędzia i zapytania.

Liczby pochodzą z tych samych danych co Twoje raporty. Aby asystent dokładnie odtworzył Twoje liczby, poproś go o zastosowanie reguł z Twoich Ustawień raportów, na przykład o wykluczenie anulowanych zamówień.

Przykładowe pytania

  • Jaki był mój przychód we wrześniu w porównaniu z wrześniem zeszłego roku?
  • Jakie są moje 10 najlepiej sprzedających się produktów w tym kwartale, wraz z ich przychodem?
  • Porównaj dzień po dniu moje wydatki na Meta Ads i moją sprzedaż z ostatnich 30 dni.
  • Które zapytania w Search Console przynoszą najwięcej kliknięć na karty moich produktów?
  • Podsumuj zgłoszenia otrzymane w Crisp w tym tygodniu.

Odetnij dostęp

Przy połączeniu kontem usuń konektor Fullmetrix w ustawieniach swojego klienta, czy to Claude, ChatGPT, czy innego.

Przy połączeniu kluczem API otwórz Ustawienia, kartę Klucze API, i kliknij Odwołaj obok klucza. Klient natychmiast traci dostęp.

Najczęstsze pytania

Na tej stronie