Połącz Ringhum z Claude i innymi narzędziami AI (MCP)

Ringhum ma serwer MCP. MCP (Model Context Protocol) to standardowy sposób, w jaki aplikacje AI korzystają z zewnętrznych narzędzi. Gdy połączysz Ringhum z aplikacją AI, taką jak Claude czy ChatGPT, możesz zadawać jej pytania o swoją przestrzeń roboczą zwykłym językiem. Na przykład: „Podsumuj wczorajsze nieodebrane połączenia”, „Którzy dzwoniący poprosili o oddzwonienie w tym tygodniu?” albo „Dodaj nasze nowe godziny otwarcia do FAQ”. Aplikacja AI działa według tych samych zasad i uprawnień co API Ringhum.

Czego potrzebujesz

• Adres serwera: https://ringhum.com/mcp. Jest też pokazany na karcie Serwer MCP na stronie Deweloperzy, z przyciskiem Kopiuj.
• Aplikacji AI obsługującej zdalne serwery MCP, takiej jak Claude, ChatGPT, Claude Code, Cursor, Windsurf lub VS Code.
• Roli Właściciela lub Administratora w przestrzeni roboczej. Tylko właściciele i administratorzy mogą połączyć aplikację lub utworzyć klucz API.

Są dwa sposoby połączenia. Logowanie jest najprostsze i pasuje do aplikacji czatowych, takich jak Claude i ChatGPT. Klucz API pasuje do narzędzi deweloperskich, które przyjmują adres URL i nagłówek.

Dostęp tylko do odczytu lub do odczytu i zmiany

Ty decydujesz, ile może zrobić aplikacja AI.

Przy dostępie tylko do odczytu narzędzia zmieniające dane w ogóle nie są udostępniane aplikacji.

Ważne: Przy dostępie do zmian aplikacja AI może wysyłać prawdziwe wiadomości i wykonywać prawdziwe połączenia do Twoich klientów. Ringhum oznacza te narzędzia jako wykraczające poza Twoją przestrzeń roboczą, a usuwanie jako destrukcyjne, więc większość aplikacji AI pyta Cię przed ich uruchomieniem. Przeczytaj, co aplikacja zamierza zrobić, zanim to zatwierdzisz.

Połącz Claude przez zalogowanie

1. W Claude (w wersji przeglądarkowej, na komputerze lub w telefonie) otwórz Ustawienia → Łączniki i wybierz Dodaj niestandardowy łącznik.
2. Wklej https://ringhum.com/mcp jako adres URL i zapisz.
3. Kliknij Połącz. Otworzy się strona Ringhum. Zaloguj się, jeśli zostaniesz o to poproszony.
4. Na stronie Połącz wybierz Przestrzeń roboczą, której aplikacja może używać.
5. W sekcji Co może robić wybierz Wyszukiwanie danych albo Wyszukiwanie danych i wprowadzanie zmian.
6. Kliknij Zezwól. Zostajesz przekierowany z powrotem do Claude.

Aplikacja nigdy nie widzi Twojego hasła. Dokładne nazwy menu w Claude mogą się z czasem zmieniać; szukaj łączników lub integracji w jej ustawieniach.

ChatGPT: dodaj adres URL jako niestandardowy łącznik (serwer MCP) w Ustawienia → Aplikacje i łączniki, a następnie kliknij Połącz i wykonaj kroki od 3 do 6.

Claude Code: uruchom poniższe polecenie, a następnie uruchom /mcp i wybierz Uwierzytelnij.

claude mcp add --transport http ringhum https://ringhum.com/mcp

Po zezwoleniu na dostęp połączenie odnawia się samo, dopóki nadal z niego korzystasz. Jeśli aplikacja nie jest używana przez 90 dni, trzeba będzie połączyć ją ponownie.

Połącz za pomocą klucza API

Użyj tego dla narzędzi pozwalających ustawić nagłówek żądania, albo gdy nie chcesz się logować.

1. W Deweloperzy utwórz klucz API. Zaznacz tylko read dla połączenia tylko do odczytu, albo read i write, aby zezwolić na zmiany. Zobacz Klucze API i uprawnienia.
2. Dodaj serwer do swojej aplikacji z kluczem w nagłówku Authorization.

Claude Code:

claude mcp add --transport http ringhum https://ringhum.com/mcp \
  --header "Authorization: Bearer ck_live_…"

Cursor (~/.cursor/mcp.json), Windsurf i Claude Desktop:

{
  "mcpServers": {
    "ringhum": {
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "ringhum": {
      "type": "http",
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

Aplikacja, która może uruchamiać tylko lokalne serwery, może połączyć się przez npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

Co obejmują narzędzia

Każda operacja w API Ringhum jest dostępna jako narzędzie: Twoje konto i zużycie, asystenci, numery telefonów, połączenia i transkrypcje, kontakty, wizyty i dostępność, zamówienia i produkty, rezerwacje pokoi, panel Odebrane, wiadomości tekstowe i WhatsApp, kampanie, webhooki, profil firmy, usługi, FAQ i baza wiedzy, pytania bez odpowiedzi, linki do płatności, prośby o opinię, przychody i ochrona przed spamem. Jedynym wyjątkiem są nagrania połączeń: nie są dostępne jako narzędzie.

Każde narzędzie wykonuje odpowiadające mu żądanie API, więc obowiązują te same limity planu, walidacja i limity zapytań. Wywołania narzędzi liczą się do limitu API wynoszącego 120 żądań na minutę. Pełna lista narzędzi znajduje się w sekcji MCP dokumentacji API pod adresem /docs.

Zobacz i odłącz połączone aplikacje

Aplikacje, które połączyłeś przez zalogowanie, są wymienione w Deweloperzy w sekcji Połączone aplikacje AI, wraz z informacją, kto je połączył, ich Dostępem (Tylko odczyt lub Odczyt i zmiana) oraz kiedy były ostatnio używane.

Aby usunąć aplikację, kliknij Odłącz i potwierdź. Traci dostęp od razu i musi zostać ponownie zatwierdzona. Aby zmienić dostęp aplikacji, odłącz ją i połącz ponownie z inną opcją.

Dla połączenia utworzonego za pomocą klucza API unieważnij klucz w Klucze API.

Rozwiązywanie problemów

„Tylko właściciele i administratorzy przestrzeni roboczej mogą łączyć aplikacje.” Poproś właściciela przestrzeni roboczej o połączenie aplikacji albo o nadanie Ci roli Administratora. Zobacz Zaproś swój zespół.

„Żądanie logowania wygasło. Zacznij łączenie ponownie ze swojej aplikacji AI.” Strona zatwierdzenia była otwarta zbyt długo. Zacznij ponownie ze swojej aplikacji AI.

Aplikacja mówi, że nie jest autoryzowana, albo prosi o ponowne zalogowanie. Aplikacja została odłączona, klucz został unieważniony, albo nie jesteś już członkiem przestrzeni roboczej. Połącz ją ponownie.

Aplikacja nie może wprowadzać zmian. Została połączona z dostępem tylko do odczytu, albo jej klucz API nie ma uprawnienia write.

Aplikacja patrzy na niewłaściwą przestrzeń roboczą. Poproś ją o wywołanie who_am_i, aby to sprawdzić. Każde połączenie korzysta z jednej przestrzeni roboczej. Odłącz ją i połącz ponownie, aby wybrać inną.