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
- Otwórz Account na pasku bocznym i znajdź API keys for AI agents.
- Nazwij klucz od miejsca, w którym będzie używany, na przykład Claude Code na moim laptopie, i kliknij Make a key.
- 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:
--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:
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ędzia | Co robią |
|---|---|
list_chatbots, get_chatbot | Twoje chatboty oraz instrukcje, ustawienia, kod do osadzenia i link do udostępnienia wybranego chatbota. |
create_chatbot | Nowy chatbot jako wersja robocza, z którą możesz rozmawiać tylko Ty. |
update_chatbot | Jego 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_pages | Znajduje podstrony witryny, a potem dodaje wybrane do wiedzy. |
add_text, add_qa, list_knowledge, remove_source | Teksty i pytania z odpowiedziami, lista źródeł i usuwanie źródła. |
ask_chatbot | Zadaje 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_chatbot | Uruchamia 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_conversation | O 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_evaluation | Pytania testowe z opisem dobrej odpowiedzi i oceniany test na ich podstawie, rozliczany z Twojego klucza OpenRouter. |
get_usage | Kredyty 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.