Publiczne API

Podłączyć asystenta AI (MCP)

Utwórz klucz API tylko z zakresami, których asystent potrzebuje, i podaj klientowi adres https://api.mosaqo.app/v1/mcp z tym kluczem jako tokenem bearer. Asystent może dokładnie to, na co pozwala klucz, i nic więcej, a odłączyć go można w każdej chwili w Bulk & API.

Sprawdzono 20 sierpnia 2026

Kroki

1. Otwórz Bulk & API → API keys i utwórz klucz. Najpierw nadaj zakresy tylko do odczytu; drugi, z zapisem, wydasz, gdy zobaczysz, co asystent robi.
2. Skopiuj adres z panelu AI assistants (MCP) na tym samym ekranie.
3. W asystencie dodaj serwer z tym adresem i wysyłaj klucz w nagłówku Authorization: Bearer. Większość klientów przyjmuje blok JSON z url i headers.
4. Niektóre konektory proszą o zalogowanie w Mosaqo zamiast wklejania klucza. Ta droga pokazuje, kto prosi, której przestrzeni to dotyczy i co mógłby zrobić, zanim cokolwiek zostanie przyznane — zatwierdzić może tylko właściciel albo administrator.
5. Zapytaj asystenta, co potrafi. Wymieni narzędzia, na które pozwala twój klucz — to najszybsze potwierdzenie, że połączenie jest tak wąskie, jak chciałeś.

Jak sprawdzić wynik

Zapytaj o coś, co wie tylko ta przestrzeń: ile masz kodów albo jak idzie ankieta. Odpowiedź z twoimi prawdziwymi nazwami i liczbami znaczy, że połączenie działa; odmowa z nazwą zakresu znaczy, że klucz jest węższy niż pytanie.

Co zwykle idzie nie tak

• Nadanie zapisu już pierwszemu kluczowi. Zacznij od odczytu i poszerz, gdy będziesz wiedzieć, co się z nim dzieje.
• Oczekiwanie, że przeczyta to, co ludzie napisali w ankiecie. Te odpowiedzi nie trafiają ani do klucza, ani do asystenta — oceny i liczby tak, zdania zostają w skrzynce.
• Oczekiwanie, że usunie kod. Nie może: zniszczenie przekierowania za wydrukowanym kodem jest nieodwracalne, więc oferuje mu się archiwizację, którą da się cofnąć.
• Zapomnienie o połączeniu. Asystent podłączony przez logowanie ma dostęp, dopóki nie odłączysz go w Bulk & API — tak jak klucz działa, dopóki go nie unieważnisz.