Podłącz własnego agenta AI lub własne oprogramowanie do Tolk2Go
Co możesz podłączyć
- Inne narzędzia AI, takie jak Microsoft Copilot, Gemini czy Cursor.
- Kreatory agentów, takie jak n8n lub Zapier.
- Własny chatbot lub asystent.
- Własne oprogramowanie, na przykład system do planowania lub zarządzania sprawami, które rezerwuje tłumaczy bezpośrednio przez API Tolk2Go, bez udziału AI.
Narzędzia AI łączą się z serwerem MCP Tolk2Go (Model Context Protocol over Streamable HTTP). Własne oprogramowanie korzysta z REST API, opisanego w kontrakcie OpenAPI. Wyszukiwanie języków, specjalizacji i dostępnych tłumaczy jest publiczne i nie wymaga logowania. Rezerwacja zawsze odbywa się w imieniu jednego konta klienta Tolk2Go.
Logowanie za pomocą OAuth
Dla klientów MCP, którzy obsługują logowanie przez OAuth. Klucz nie jest wymagany.
- Dodaj serwer MCP
https://api.tolk2go.com/api/v1/mcpdo klienta. - Zaloguj się i zezwól. Klient otwiera stronę Tolk2Go. Użytkownik loguje się za pomocą swojego konta klienta Tolk2Go i wybiera opcję Zezwól na dostęp. Hasło pozostaje w Tolk2Go.
- Odłącz w dowolnym momencie w sekcji Dostęp agenta AI na koncie.
Tolk2Go obsługuje OAuth 2.1 z PKCE i dynamiczną rejestracją klientów. Metadane serwera autoryzacji są dostępne pod adresem https://api.tolk2go.com/.well-known/oauth-authorization-server.
Łączenie za pomocą klucza agenta
Dla klientów bez obsługi OAuth oraz dla własnego oprogramowania korzystającego z REST API.
- Użyj konta Tolk2Go, do którego należą rezerwacje. Nie masz jeszcze konta? Najpierw utwórz konto.
- Utwórz klucz agenta. Zaloguj się i otwórz sekcję Dostęp agenta AI na koncie, wybierz Utwórz klucz i skopiuj klucz. Jest on wyświetlany tylko raz: zapisz go w bezpiecznych ustawieniach klienta, nigdy na czacie ani w prompcie.
- Połącz klienta z serwerem MCP Tolk2Go za pomocą klucza (przykładowa konfiguracja poniżej) lub przekaż mu kontrakt OpenAPI. Klient może również wygenerować klucz samodzielnie po jednorazowym zalogowaniu się przez API.
- Wymień lub unieważnij klucz w dowolnym momencie w sekcji Dostęp agenta AI. Unieważniony klucz natychmiast przestaje działać.
Adresy
| Co | Adres |
|---|---|
| Serwer MCP (Streamable HTTP) | https://api.tolk2go.com/api/v1/mcp |
| Kontrakt OpenAPI | https://api.tolk2go.com/api/v1/spec |
| Przewodnik dla agentów AI | https://www.tolk2go.com/llms.txt |
| Umiejętność agenta i przykłady konfiguracji | github.com/Tolk2Go-Organization/agent-skills |
Przykładowa konfiguracja klienta MCP z kluczem agenta:
{
"mcpServers": {
"tolk2go": {
"type": "http",
"url": "https://api.tolk2go.com/api/v1/mcp",
"headers": { "Authorization": "Bearer t2g_agent_..." }
}
}
}
Chcesz od razu udostępnić swojemu agentowi pełną ścieżkę rezerwacji? Zainstaluj umiejętność agenta Tolk2Go za pomocą npx skills add Tolk2Go-Organization/agent-skills.
Bezpieczeństwo
- Tylko jedno konto. Połączona aplikacja lub klucz agenta mogą widzieć rezerwacje i zarządzać nimi wyłącznie w ramach konta, które je połączyło.
- Wyświetlany raz, bezpiecznie przechowywany. Klucz agenta jest wyświetlany tylko w momencie jego wygenerowania. Tolk2Go przechowuje wyłącznie bezpieczny skrót, nigdy sam klucz.
- Ograniczony czas ważności. Klucze są domyślnie ważne przez 90 dni (można wybrać od 7 do 365 dni), dzięki czemu agent może powrócić po kilku tygodniach bez konieczności ponownego logowania.
- Odnawiaj, unieważniaj lub odłączaj w dowolnym momencie. W sekcji dostępu dla agenta AI klient widzi każdy klucz wraz z datą jego ostatniego użycia oraz każdą połączoną aplikację i może jednym kliknięciem wymienić lub unieważnić klucz albo odłączyć aplikację.
- Nigdy nie stracisz dostępu. Zgubiłeś klucz? Unieważnij go na koncie i utwórz nowy. Standardowe logowanie do konta zawsze działa.
- Brak płatności przez agenta. Gdy wymagana jest przedpłata, agent otrzymuje bezpieczny link do płatności dla klienta.
Najczęściej zadawane pytania
Jakie aplikacje klienckie są obsługiwane?
Dowolny asystent lub agent obsługujący protokół Model Context Protocol (MCP) przez Streamable HTTP, z logowaniem OAuth lub kluczem agenta, a także dowolne oprogramowanie mogące wywołać REST API opisane w OpenAPI.
Co się stanie, jeśli klucz agenta zostanie zgubiony lub wycieknie?
Zaloguj się, unieważnij klucz w sekcji dostępu dla agenta AI na koncie i utwórz nowy. Unieważniony klucz przestaje działać, a ponadto miał dostęp wyłącznie do rezerwacji tego jednego konta.
Czy nasze własne oprogramowanie może dokonywać rezerwacji bez asystenta AI?
Tak. REST API oferuje takie same funkcje wyszukiwania, rezerwacji i dalszych działań jak serwer MCP. Zobacz kontrakt OpenAPI powyżej.
Potrzebujesz pomocy w integracji?
Chętnie pomożemy Twojemu działowi IT lub programiście w połączeniu z Tolk2Go.