MCP
Połącz Claude, Cursora lub dowolnego klienta MCP ze zdalnym serwerem WASync. Sześć narzędzi, bez kodu po Państwa stronie.
WASync udostępnia zdalny serwer MCP przez Streamable HTTP. Dodają go Państwo do klienta MCP i agent otrzymuje narzędzia WhatsApp bez żadnego kodu po Państwa stronie.
https://cloudapi.wasync.app/api/mcpTen host jest wybrany celowo. Bazowy adres REST i wszystkie linki przeznaczone
dla ludzi używają developers.wasync.app, ale adres serwera MCP, punkty końcowe
OAuth i dokumenty /.well-known/… to identyfikatory protokołu, które klienci
już zarejestrowali — pozostają na cloudapi.wasync.app i muszą zgadzać się co
do bajta. Nie należy ich „normalizować”.
Połączenie klienta
Dla klientów, które czytają plik konfiguracyjny (Claude Desktop, Cursor, …):
{
"mcpServers": {
"wasync": {
"url": "https://cloudapi.wasync.app/api/mcp"
}
}
}Uwierzytelnianie to OAuth 2.0 z PKCE, obsługiwane przez klienta: pierwsze wywołanie otwiera przeglądarkę, zatwierdzają Państwo dostęp, a klient zapisuje tokeny. Nie trzeba niczego wklejać — nie ma klucza.
Klient bez natywnej obsługi zdalnego MCP może połączyć się przez stdio:
npx mcp-remote https://cloudapi.wasync.app/api/mcpWyszukiwanie w rejestrze
WASync znajduje się w oficjalnym rejestrze MCP pod nazwą:
app.wasync/whatsappKlienci i katalogi, które czytają rejestr, mogą znaleźć serwer po nazwie, bez wklejania adresu URL.
Narzędzia
| Tool | What it does | Needs |
|---|---|---|
list_whatsapp_connections | Wyświetla połączenia, z których może korzystać dany dostęp, wraz ze statusem i stanem licencji. Każde inne narzędzie przyjmuje identyfikator połączenia z tej listy. | read |
get_whatsapp_connection | Aktualny stan jednego połączenia: czy jest online, status licencji i data wygaśnięcia. Tylko do odczytu. | read |
read_whatsapp_messages | Zapisane wiadomości, od najnowszych, ze wszystkich udostępnionych połączeń lub z jednego; stronicowane przez nextCursor. Nic nie jest wysyłane i nie pojawia się potwierdzenie odczytu. | read |
send_whatsapp_message | Wysyła wiadomość tekstową z jednego połączenia do jednego odbiorcy. Opis narzędzia nakazuje modelowi najpierw potwierdzić odbiorcę i treść: wiadomości WhatsApp nie da się wycofać. | send |
send_whatsapp_file | Wysyła plik (dokument, obraz, audio lub wideo, do 5 MB) z opcjonalnym podpisem. Podaj bezpośredni link https w url (zalecane) lub base64 w data. Obowiązuje ta sama zasada potwierdzenia: nie można tego wycofać. | send |
mark_whatsapp_messages_read | Oznacza wiadomości przychodzące jednego klienta jako przeczytane (niebieskie ptaszki), według numeru telefonu lub identyfikatora wiadomości. | send |
Odpowiadają one wywołaniom GET /connections, GET /connections/{id},
GET /messages, POST /messages (tekst i multimedia) oraz
POST /messages/read i podlegają tym samym zakresom —
agent może zrobić tylko to, na co pozwala przyznany dostęp.
Wysyłanie pliku
send_whatsapp_file przyjmuje dokładnie jedno z pól: url lub data:
{
"connectionId": "conn_123",
"to": "40700000000",
"url": "https://files.example.com/offers/offer-2026.pdf",
"filename": "offer-2026.pdf",
"caption": "Here is the offer we discussed."
}urlmusi być bezpośrednim linkiemhttps://do pliku, który każdy w internecie może otworzyć bez logowania. WASync pobiera go (do 5 MB, w ciągu 20 sekund) i bierzemimetypez odpowiedzi serwera plików, o ile nie podadzą go Państwo sami. Linki prowadzące do sieci prywatnych, do samego WASync lub do strony internetowej zamiast pliku są odrzucane.datato plik jako zwykły base64 (bez prefiksudata:), po zdekodowaniu nie większy niż 5 MB; wtedymimetypejest wymagany. Lepiej użyćurl: przesyłanie bajtów pliku w rozmowie z modelem jest powolne i kosztowne.filenameto nazwa widoczna dla odbiorcy (bez ukośników);captionjest opcjonalny, do 1024 znaków.
Błędy wracają jako błędy narzędzia ze stałym kodem na początku komunikatu:
invalid_url, url_not_allowed, download_failed, file_too_large,
invalid_media lub send_failed: <reason>, gdy WASync odrzucił wysyłkę.
MCP czy REST API?
MCP warto wybrać, gdy agent nadzorowany przez człowieka ma mieć dostęp do WhatsApp: odpowiadanie z klienta czatu, przygotowywanie odpowiedzi, wyszukiwanie informacji. REST API jest właściwe, gdy zachowanie kontroluje Państwa własne oprogramowanie i potrzebne są webhooks, klucze idempotentności, pliki większe niż 5 MB lub provisioning — żadna z tych rzeczy nie jest dostępna przez MCP.
Dostęp OAuth jest przyznawany wyłącznie dla połączeń, które już istnieją, więc MCP nie może utworzyć pierwszego połączenia w workspace. Najpierw utwórz je za pomocą API key: Szybki start.