Przejdź do treści

Agenci AI i MCP

Zaktualizowano

Agent AI, taki jak Claude Code czy Cursor, może za Ciebie budować i prowadzić Twoje chatboty: utworzyć chatbota, dodać Twoją stronę do jego wiedzy, napisać mu instrukcje, wypróbować go i uruchomić. Łączy się z serwerem MCP ChatFrom: tworzysz klucz API w ChatFrom i dodajesz jedną linijkę do konfiguracji agenta.

Co to daje

ChatFrom ma serwer MCP. MCP to standardowy sposób, w jaki agenci AI korzystają z innych usług. Gdy Twój agent jest połączony, możesz poprosić go zwykłymi słowami, na przykład „zrób chatbota dla orbitdesk.io z jego stron pomocy i uruchom go tam”, a on sam wykona kolejne kroki, z tymi samymi kontrolami co w panelu. Działa z Twoimi uprawnieniami: widzi Twoje chatboty i niczyje inne, a limity i kredyty Twojego planu obowiązują go tak samo jak Ciebie.

1. Utwórz klucz API

  1. Otwórz Account na pasku bocznym i znajdź API keys for AI agents.
  2. Nazwij klucz od miejsca, w którym będzie używany, na przykład Claude Code na moim laptopie, i kliknij Make a key.
  3. Skopiuj klucz. Zaczyna się od cf_ i jest pokazywany tylko raz: ChatFrom przechowuje jedynie jego odcisk cyfrowy, więc nikt nie pokaże Ci go ponownie. Jeśli go zgubisz, usuń go i utwórz nowy.

Konto może mieć 10 kluczy. Osobny klucz dla każdego agenta lub komputera pozwala wyłączyć jeden bez wyłączania pozostałych.

2. Połącz swojego agenta

W Claude Code najprościej skopiować linijkę, którą strona Account pokazuje razem z nowym kluczem, bo jest już w niej Twój klucz, i uruchomić ją raz w terminalu. W pełnej postaci, z Twoim kluczem w miejscu cf_your_key, wygląda tak:

Claude CodeTerminal
claude mcp add --scope user --transport http chatfrom https://chatfrom.io/api/agent/mcp --header "Authorization: Bearer cf_your_key"

--scope user sprawia, że ChatFrom jest dostępny w każdym folderze, w którym otworzysz Claude Code; bez tej opcji tylko w folderze, w którym uruchomiono polecenie. Żeby to sprawdzić, uruchom claude mcp list: ChatFrom powinien być widoczny jako połączony. Sesja, która była już otwarta, go nie widzi, więc zacznij nową.

W Cursor dodaj ChatFrom do ~/.cursor/mcp.json albo, dla jednego projektu, do .cursor/mcp.json:

CursorJSON
{
  "mcpServers": {
    "chatfrom": {
      "url": "https://chatfrom.io/api/agent/mcp",
      "headers": { "Authorization": "Bearer cf_your_key" }
    }
  }
}

Każdy inny agent, który łączy się z serwerem MCP przez HTTP, działa tak samo: adres to https://chatfrom.io/api/agent/mcp, a w nagłówku Authorization podajesz Bearer i po nim swój klucz.

Połącz z poziomu Claude, bez klucza

Konektory Claude logują Cię, zamiast prosić o klucz. Otwórz ChatFrom w katalogu Claude, dodaj go i kliknij Connect. ChatFrom poprosi Cię o zalogowanie i pokaże, co Claude będzie mógł robić; kliknij Allow, a wrócisz do Claude. Tak samo działa własny konektor z adresem https://chatfrom.io/api/agent/mcp.

Aplikacje połączone w ten sposób zobaczysz i odłączysz w Account, w części Connected apps. Odłączona aplikacja od razu przestaje działać. Tak połączona aplikacja może robić to samo, na co endpoint agenta pozwala kluczowi, i ma te same ograniczenia.

Jeśli agent, który ma od Ciebie klucz, prosi Cię zamiast tego o zalogowanie, klucz już nie działa. Utwórz nowy w Account.

Co może zrobić Twój agent

NarzędziaCo robią
list_chatbots, get_chatbotTwoje chatboty oraz instrukcje, ustawienia, kod do osadzenia i link do udostępnienia wybranego chatbota.
create_chatbotNowy chatbot jako wersja robocza, z którą możesz rozmawiać tylko Ty.
update_chatbotJego nazwa, instrukcje, model, język, wiadomość powitalna, proponowane pytania, wiadomość na wypadek braku odpowiedzi, ton i szczegółowość; ograniczenia tematyczne; pamięć; oraz to, czy przekazuje rozmowę człowiekowi i na jaki adres: Twój własny albo już potwierdzony.
find_pages, add_pagesZnajduje podstrony witryny, a potem dodaje wybrane do wiedzy.
add_text, add_qa, list_knowledge, remove_sourceTeksty i pytania z odpowiedziami, lista źródeł i usuwanie źródła.
ask_chatbotZadaje chatbotowi pytanie, tak jak Ty w Try it, czyta jego odpowiedź i źródła oraz odpowiada na pytania zadawane w Twoich workflowach. Kontynuuje własne rozmowy z Try it, nigdy rozmowy odwiedzającego.
deploy_chatbotUruchamia chatbota albo przywraca go do wersji roboczej, ustawia strony, na których może działać, to, czy działa w aplikacjach mobilnych, i wygląd widżetu, a także podaje kod do osadzenia i link do udostępnienia.
list_conversations, get_conversationO co pytali odwiedzający, z filtrem na rozmowy bez odpowiedzi, źle ocenione lub przekazane, oraz pojedyncza rozmowa, przy długiej najpierw najnowsze wiadomości.
list_evaluations, add_evaluation_dataset, run_evaluationPytania testowe z opisem dobrej odpowiedzi i oceniany test na ich podstawie, rozliczany z Twojego klucza OpenRouter.
get_usageKredyty zużyte w tym miesiącu i to, kiedy się odnowią.

Dobra pierwsza prośba to „pokaż moje chatboty ChatFrom”: jeśli agent je wymieni, jest połączony. Odpowiedzi z ask_chatbot i dodawanie wiedzy zużywają Twoje miesięczne kredyty, tak samo jak w panelu.

ask_chatbot uruchamia prawdziwe narzędzia chatbota, tak jak zrobiłaby to wiadomość odwiedzającego: pytanie, które prowadzi do przekazania rozmowy, rezerwacji, wiersza w Twoim arkuszu albo własnej akcji, naprawdę je wywołuje, również w chatbocie w wersji roboczej.

Czego nie może zrobić

  • Usunąć chatbota ani Twojego konta, ani zmienić planu czy rozliczeń. Te zmiany zostają w panelu, gdzie trzeba je potwierdzić.
  • Tworzyć, przeglądać ani usuwać kluczy API, więc jeden klucz nie może utworzyć kolejnego.
  • Łączyć komunikatorów ani usług, takich jak WhatsApp czy Shopify. Konfigurujesz je w panelu, gdzie wymagają zalogowania lub Twoich kluczy.
  • Przekazywać rozmów na nowy adres e-mail. Może ustawić adres, którego używasz do logowania, albo adres już potwierdzony dla innego z Twoich chatbotów; każdy inny ustawiasz w sekcji Behaviour, która wysyła na ten adres link do potwierdzenia.
  • Przekraczać limitów planu: chatbot, źródło czy kredyt ponad limit zostaje odrzucony z podaniem powodu, tak jak w Twoim przypadku.

Każdy klucz może wysłać 120 żądań na minutę, więcej, niż potrzebuje agent, a wszystkie Twoje klucze i połączone aplikacje łącznie 300.

Chroń swój klucz

  • Klucz ma Twoje uprawnienia, więc traktuj go jak hasło: trzymaj go w ustawieniach agenta, nigdy w kodzie, który udostępniasz, ani w publicznym repozytorium. Ktoś inny z Twoim kluczem mógłby zmieniać Twoje chatboty i zużywać Twoje kredyty.
  • Strona Account pokazuje, kiedy każdy klucz był ostatnio użyty. Usuń klucz, którego już nie używasz, albo taki, który mógł zobaczyć ktoś inny; od razu przestanie działać.
  • Usunięcie konta usuwa też jego klucze.
  • Rozmowy zawierają to, co napisali Twoi odwiedzający. Gdy agent je czyta, ich słowa trafiają do agenta i do firmy, na której modelu AI działa, a odwiedzający może napisać słowa, które mają nim sterować. Narzędzia ChatFrom każą agentowi traktować je jako informacje, nigdy jako polecenia; zanim agent zadziała na podstawie rozmowy, przeczytaj, co proponuje.

Endpoint agenta jest opisany dla programistów w dokumentacji API. Te same klucze działają w węźle n8n i w rozszerzeniu przeglądarki. Jak samodzielnie skonfigurować chatbota krok po kroku, opisuje przewodnik Pierwsze kroki.