Przeglądaj centrum pomocy

Połącz swojego asystenta AI (MCP)

Opiekun: Vitalii VlasiukCo-founder

Transept udostępnia endpoint MCP, z którym asystenci AI łączą się bezpośrednio. Po połączeniu asystent może zarządzać całym procesem (importować dokumenty, uruchamiać wielojęzyczne przepływy pracy, zarządzać glosariuszami i przewodnikami stylu oraz odczytywać wyniki), podczas gdy Twoje uprawnienia i saldo słów pozostają pod Twoją kontrolą.

Na tej stronie

Czym jest endpoint MCP?

MCP (Model Context Protocol) to standard, którego asystenci AI używają do wywoływania zewnętrznych narzędzi. Transept udostępnia dla niego jeden endpoint, https://app.transept.ai/api/public/v1/mcp, a połączony z nim asystent zyskuje te same możliwości, które skrypt otrzymuje przez API, podane w formie narzędzi do samodzielnego wywoływania: tworzenie dokumentu, wycena zadania, uruchomienie go, sprawdzanie statusu czy odczytanie gotowych tłumaczeń.

Praktyczna różnica względem wklejania tekstu do czatu: asystent pracuje na Twoich rzeczywistych dokumentach, z zastosowaniem Twoich glosariuszy, przewodników stylu i pamięci tłumaczeniowej. Wyniki trafiają do Transept, gdzie możesz je przejrzeć i wyeksportować jak każde inne zadanie.

Jak połączyć Claude Code, Claude Desktop lub Cursor?

Połączenie wykorzystuje standard OAuth: dodaj adres URL w swoim kliencie, a przy pierwszej próbie połączenia otworzy się okno przeglądarki z prośbą o zatwierdzenie dostępu. Po jego zatwierdzeniu klient zostanie powiązany; nie trzeba wklejać żadnego klucza. Gotowe fragmenty konfiguracji dla każdego klienta znajdziesz w aplikacji na stronie Integracje.

To jednorazowa konfiguracja dla każdego klienta MCP.
KlientKonfiguracja
Claude CodeUruchom claude mcp add --transport http transept https://app.transept.ai/api/public/v1/mcp w terminalu
Claude DesktopUstawienia → Konektory → Dodaj własny konektor, wklej adres URL endpointu
CursorDodaj serwer z wpisem "url": "https://app.transept.ai/api/public/v1/mcp" do pliku mcp.json
PozostałeDowolny klient MCP obsługujący strumieniowe HTTP: skieruj go na ten sam adres URL

Czy potrzebuję klucza API?

Nie dotyczy to klientów interaktywnych – ich obsługuje OAuth. Klucze są przeznaczone dla maszyn, które nie mogą otworzyć przeglądarki. W obu przypadkach połączenie trafia do sekcji Ustawienia → Deweloper jako wpis z możliwością cofnięcia dostępu, więc odłączenie asystenta to kwestia jednego kliknięcia, niezależnie od tego, jak zostało nawiązane.

OAuth lub klucz API, zależnie od tego, jak działa asystent.
Sposób połączeniaMetoda autoryzacji
Asystent, z którym pracujesz bezpośrednio (Claude, Cursor)OAuth: zgoda w przeglądarce przy pierwszym połączeniu, nic nie trzeba wklejać
CI, serwer, agent headlessKlucz API z sekcji Ustawienia → Deweloper, przesyłany jako nagłówek Authorization: Bearer

Co właściwie potrafi asystent?

Narzędzia obsługują cały proces od początku do końca, dzięki czemu jedna rozmowa wystarczy, by przeprowadzić dokument od importu aż po zweryfikowane tłumaczenia:

  • Import treści: wklejane dokumenty lub katalog ciągów znaków z kluczami, kontekstami i symbolami zastępczymi.
  • Bezpłatna wycena każdego zadania, uruchamianie przepływu pracy dla wszystkich języków docelowych jednocześnie oraz sprawdzanie postępu dla każdego z nich.
  • Tworzenie i rozbudowywanie glosariuszy, korzystanie z przewodników stylu oraz przeszukiwanie pamięci tłumaczeniowej przed rozpoczęciem tłumaczenia.
  • Odczytywanie wyników: blok po bloku dla tekstów ciągłych lub według identyfikatorów ciągów znaków dla katalogów.
  • Rejestrowanie webhooków, aby Twoje systemy otrzymywały podpisane zdarzenie po zakończeniu zadania.
  • Co z założenia pozostaje poza zakresem: przesyłanie plików i eksporty binarne (DOCX, XLIFF, TMX) są obsługiwane przez API REST, a zarządzanie kluczami pozostaje czynnością wykonywaną przez człowieka w aplikacji; asystent nigdy nie może samodzielnie wygenerować sobie klucza.

Jak chronione są moje wydatki?

Trzy zabezpieczenia, wszystkie egzekwowane po stronie Transept, a nie powierzone asystentowi:

  • Uprawnienia. Każde wywołanie narzędzia jest sprawdzane pod kątem udzielonych przez Ciebie uprawnień: zakresu klucza lub zgody OAuth. Wywołanie wykraczające poza ten zakres jest odrzucane wraz z informacją o brakującym uprawnieniu.
  • Wycena, potem potwierdzenie. Każda operacja wiążąca się z kosztem najpierw zwraca wycenę liczby słów i na tym poprzestaje. Zadanie uruchamia się dopiero po wyraźnym potwierdzeniu przez asystenta, co oznacza, że widzisz cenę w oknie czatu, zanim koszty zostaną faktycznie poniesione. Bramki weryfikacji w przepływach pracy nadal wstrzymują proces; jego kontynuacja wymaga wyraźnej zgody – Twojej lub asystenta działającego na Twoje polecenie.
  • Cofnięcie dostępu. Połączenie możesz przerwać ze swojej strony w dowolnym momencie: kolejne wywołanie asystenta, któremu cofnięto dostęp, zostanie odrzucone – nawet w samym środku rozmowy.

Czy treści mogą przepływać w obie strony bez konieczności korzystania z aplikacji?

Tak: powiąż połączenie z wyzwalaczem webhooka, a pętla się domyka. Twoja platforma e-mailowa, CMS lub skrypt przesyła treść metodą POST pod adres URL wyzwalacza (treść żądania staje się dokumentem), przepływ pracy ją tłumaczy, a webhook lub asystent odczytuje gotowe tłumaczenia: dziesięć języków na wyjściu w zamian za jeden szablon na wejściu, bez konieczności otwierania edytora.

To mechanizm stojący za lokalizacją szablonów e-mail i ciągłą pracą z katalogiem ciągów znaków: platforma przesyła to, co się zmieniło, Transept tłumaczy tylko te fragmenty, a Twój potok pobiera wyniki. Twoim zadaniem jest weryfikacja – cała mechaniczna praca zostaje oddelegowana.

Częste pytania

Czy asystent może zużywać moje słowa bez pytania?

Nie. Każde narzędzie, które miałoby uruchomić płatne zadanie, najpierw zwraca wycenę liczby słów i na tym poprzestaje; asystent musi wyraźnie potwierdzić operację przed rozpoczęciem zadania, a potwierdzenie to jest widoczne w oknie czatu. Bezpłatne czynności (importowanie, wycenianie, odczytywanie wyników) nie wymagają potwierdzenia, ponieważ nigdy nie generują kosztów.

Jak odłączyć asystenta?

W sekcji Ustawienia → Deweloper. Każde połączenie (zgoda OAuth lub wklejony klucz) jest tam widoczne jako pozycja z możliwością cofnięcia dostępu. Wystarczy cofnąć dostęp, a kolejne wywołanie asystenta zostanie odrzucone; nie musisz niczego czyścić po stronie asystenta.

Które klienty MCP są obsługiwane?

Każdy klient obsługujący protokół MCP przez strumieniowe HTTP: Claude Code, Claude Desktop, Cursor oraz nowsze frameworki agentowe – wszystkie one spełniają te kryteria. Klienty interaktywne łączą się za pomocą OAuth, natomiast te typu headless przesyłają klucz API jako nagłówek Bearer. W obu przypadkach punkt końcowy to ten sam adres URL.

Poznaj funkcje

Nadal potrzebna pomoc? Warto zapytać Literess w aplikacji lub napisać na adres [email protected].