Serwer MCP

1. Hostowany (mcp.bird.com): URL i logowanie w przeglądarce. Nic do instalacji, bez CLI, bez klucza API. To zalecana ścieżka.
2. Lokalny przez stdio (bird mcp): narzędzia działające na Twoim komputerze wewnątrz bird CLI, dla agentów powłoki lub samodzielnego uruchomienia.

• auth_signup, auth_verify_email i auth_create_org: te narzędzia tworzą Twoje pierwsze poświadczenie, zanim możesz się uwierzytelnić na serwerze hostowanym.
• compliance_attachments_upload: to narzędzie odczytuje lokalną ścieżkę do pliku. Na serwerze hostowanym ta ścieżka wskazywałaby na system plików serwera i mogłaby przesłać niewłaściwy plik.

Hostowany: połącz się z mcp.bird.com

Wybierz endpoint

1. Dodaj serwer: podaj klientowi wybrany URL endpointu.
2. Uwierzytelnij się: zaloguj się przez przeglądarkę, aby klient posiadał token działający w Twoim imieniu.

Używaj dynamicznego odkrywania narzędzi

• search wyszukuje narzędzia po nazwie lub słowach kluczowych z opisu. Każde trafienie zawiera nazwę, opis, schemat wejściowy i adnotacje określające, czy narzędzie odczytuje, czy zmienia dane.
• execute wywołuje jedno wybrane narzędzie z jego argumentami. Może odczytywać dane, wysyłać wiadomości, zmieniać rekordy lub je usuwać, w zależności od wybranego narzędzia.

{
  "name": "search",
  "arguments": { "query": "workspace_get", "limit": 3 }
}

{
  "name": "execute",
  "arguments": { "tool": "workspace_get", "arguments": {} }
}

Podłącz klienta

Claude Code

claude mcp add --transport http bird https://mcp.bird.com

1. Uruchom /mcp.
2. Wybierz bird i naciśnij Enter.
3. Wybierz Authenticate. Twoja przeglądarka otworzy ekran zgody Bird; zatwierdź go tam.

Cursor

{
  "mcpServers": {
    "bird": {
      "url": "https://mcp.bird.com"
    }
  }
}

OpenCode

opencode plugin github:messagebird/bird-ai --global

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "bird": {
      "type": "remote",
      "url": "https://mcp.bird.com/dynamic"
    }
  },
  "permission": {
    "bird_execute": "ask"
  }
}

opencode mcp auth bird

VS Code

{
  "servers": {
    "bird": {
      "type": "http",
      "url": "https://mcp.bird.com"
    }
  }
}

Codex

[mcp_servers.bird]
url = "https://mcp.bird.com"

codex mcp login bird

Claude Desktop

ChatGPT

Muse

Set up a custom connector to the Bird MCP server at https://mcp.bird.com following https://bird.com/docs/ai/mcp-server.md so you can work with my Bird workspace.

Factory Droid

droid mcp add bird https://mcp.bird.com --type http

Agent Plugins

Dowolny inny host

Co się dzieje po zalogowaniu

Jak działa uzgadnianie połączenia

1. Klient wysyła nieuwierzytelnione żądanie i otrzymuje 401 z nagłówkiem WWW-Authenticate wskazującym na metadane chronionego zasobu Bird zgodne z RFC 9728 (/.well-known/oauth-protected-resource).
2. Stamtąd odkrywa serwer autoryzacji, a następnie rejestruje się dynamicznie (RFC 7591). Dynamiczna rejestracja eliminuje potrzebę współdzielonego identyfikatora klienta lub ręcznej konfiguracji.
3. Przeglądarka otwiera ekran zgody Bird.
4. Klient wymienia wynik na token dostępu (PKCE; odświeżany automatycznie) i pojawiają się narzędzia Bird.

Lokalnie: uruchom przez stdio z CLI

Cursor

{
  "mcpServers": {
    "bird": {
      "command": "bird",
      "args": ["mcp"]
    }
  }
}

VS Code

{
  "servers": {
    "bird": {
      "command": "bird",
      "args": ["mcp"]
    }
  }
}

Claude Code

claude mcp add bird -- bird mcp

Jak uwierzytelnia się lokalny serwer

Co obejmują narzędzia

Wiadomości

• Wysyłanie i sprawdzanie e-maili: email_send, email_send_batch, email_list i email_get, który zwraca wiadomość ze zbiorczym statusem dostarczenia. Statusy dostarczenia per odbiorca i dziennik zdarzeń to osobne wywołania narzędzi.
• Wysyłanie i sprawdzanie SMS: sms_send, sms_send_batch, sms_get, sms_list i sms_list_events, odzwierciedlając schemat e-maila. sms_templates_list i sms_templates_get odczytują katalog szablonów.
• Wysyłanie i sprawdzanie WhatsApp: whatsapp_send, whatsapp_get, whatsapp_list, whatsapp_list_events i whatsapp_media. Szablony to pełna powierzchnia tworzenia w ramach whatsapp_templates_*, włącznie z treścią per wersja i per język.
• Sprawdzanie odcinków połączeń głosowych: voice_legs_get i voice_legs_list odczytują odcinki połączeń. Statystyki według kraju i kodu odpowiedzi są dostępne w voice_stats_*. voice_session_credentials_create tworzy poświadczenie obszaru roboczego używane przez klienta SIP lub softphone do uwierzytelniania.
• Weryfikacja odbiorcy: verify_verifications_create wysyła jednorazowy kod weryfikacyjny, verify_verifications_check waliduje to, co odbiorca przesłał, a verify_verifications_next_channel przełącza się na inny kanał.
• Tworzenie połączenia głosowego (wersja poglądowa): voice_calls_create przygotowuje połączenie wychodzące z użyciem aktywnej publikacji włączonej, niezarchiwizowanej sekwencji. Osoba sprawdza i uruchamia żądanie w przeglądarce; samo przygotowanie nie nawiązuje połączenia. Informacje o uprawnieniach i ponawianiu prób znajdziesz w Tworzenie połączenia głosowego. Lokalny serwer bird mcp wymaga wersji CLI zawierającej to narzędzie.

Przygotowanie kanału do wysyłki

• Konfiguracja domen wysyłkowych: email_domains_create dodaje domenę wysyłkową i zwraca rekordy DNS do opublikowania; email_domains_verify ponownie je sprawdza; plus email_domains_list i email_domains_get.
• Rejestracja nadawców SMS: sms_senders_create rezerwuje nadawcę, sms_senders_requirements raportuje wymagania danego kraju, a sms_senders_registrations_create go rejestruje. Ruch A2P w USA przechodzi przez narzędzia sms_10dlc_* do marek, kampanii i zgłoszeń.
• Aprowizacja numerów: numbers_available_list wyszukuje, numbers_orders_create kupuje, a numbers_release zwraca. whatsapp_numbers_precheck raportuje, czy WhatsApp zaakceptuje numer, zanim go zamówisz.
• Sprawdzenie, czy konto w ogóle może wysyłać: narzędzia trust_* raportują wymagania organizacji warunkujące zakup numeru lub rejestrację nadawcy.

Dostarczalność e-maili

• Tworzenie szablonów e-mail: email_templates_create, email_templates_list, email_templates_get, email_templates_update, email_templates_duplicate i email_templates_preview (renderowanie wersji roboczej z przykładowymi wartościami bez wysyłki). Wersje znajdują się w email_templates_versions_*, gdzie email_templates_versions_submit zamraża wersję roboczą i czyni ją wersją serwowaną przy wysyłce, a email_templates_versions_languages_* edytuje treść wersji roboczej per język. Nic, co agent napisze, nie dotrze do odbiorcy, dopóki nie zostanie zatwierdzone.
• Zarządzanie wyciszeniami: email_suppressions_list, email_suppressions_check (czy na ten adres można bezpiecznie wysyłać?), email_suppressions_add i email_suppressions_remove (oznaczone jako destrukcyjne, ponieważ usunięcie wyciszenia bez powodu szkodzi reputacji nadawcy).
• Zarządzanie dedykowanymi IP i pulami: email_dedicated_ips_create, email_dedicated_ips_list, email_dedicated_ips_get, email_dedicated_ips_assign (przeniesienie do puli) i email_dedicated_ips_delete; plus email_ip_pools_create, email_ip_pools_list, email_ip_pools_get, email_ip_pools_update i email_ip_pools_delete dla pul, przez które kierujesz wysyłki.

Odbiorcy i konfiguracja

• Zarządzanie kontaktami i odbiorcami: contacts_* i contact_properties_* dla osób, do których wysyłasz, audiences_* dla list, do których wysyłasz, oraz preferences_* dla zgód i rezygnacji.
• Aprowizacja Realtime: realtime_apps_* i realtime_apps_keys_* tworzą aplikacje i klucze, z którymi łączą się klienty Realtime.
• Wyszukiwanie kogoś: lookup_phone_number i lookup_email raportują, co Bird wie o danym adresie, zanim na niego wyślesz.
• Podgląd konfiguracji: webhooks_list, workspace_get i whoami (zalogowany użytkownik: id, e-mail, nazwa).

Call whoami to find my email, then send me a test email from onboarding@messagebird.dev and tell me when it's delivered.

MCP czy CLI?

Następne kroki

• Wdrażanie z AI: skrócona wersja tej strony plus korpus dokumentacji do odczytu maszynowego.
• Umiejętności agenta: plugin bird-ai z marketplace, umiejętności plus ten serwer MCP, instalowane w jednym kroku.
• CLI dla agentów: steruj Bird z agentów z dostępem do powłoki bez MCP: wyjście JSON, semantyczne kody zakończenia, login OAuth.
• Uwierzytelnianie: klucze API, regiony i sposób autoryzacji żądań.