Połącz aplikacje AI (MCP)

MonoChat MCP Server pozwala aplikacji AI obsługującej Model Context Protocol (MCP), takiej jak Claude Code lub Cursor, pracować z Twoim kontem MonoChat. Aplikacja AI prosi MonoChat o dane za pomocą ustalonego zestawu narzędzi i widzi tylko to, co widzisz Ty.

MonoChat MCP Server jest dostępny w każdym planie, bez limitów zależnych od planu.

Połączenie działa jako Ty

Aplikacja AI połączona za pomocą Twojego klucza dostępu działa jako Twój użytkownik. Ma dostęp do tenantów, do których Ty masz dostęp, i do niczego więcej. Unieważniaj połączenia, z których już nie korzystasz.

Co może zrobić aplikacja AI

Te narzędzia są dostępne w każdym połączeniu:

Narzędzie	Co robi
list_tenants	Wyświetla tenantów, do których połączenie ma dostęp.
list_sessions	Wyświetla sesje rozmów tenanta, od najnowszych, opcjonalnie tylko opened, assigned lub closed.
get_session	Zwraca jedną sesję rozmowy.
list_messages	Wyświetla wiadomości sesji, od najnowszych.
search_customers	Wyszukuje klientów tenanta według słowa kluczowego.
list_message_templates	Wyświetla szablony wiadomości jednego kanału tenanta.

Tekst wiadomości pochodzi od klientów i agentów. To dane do odczytu dla aplikacji AI, a nie polecenia.

Połączenie ma zakres: Tylko odczyt lub Odczyt i zapis. Połączenie tylko do odczytu nigdy nie widzi narzędzi zmieniających dane. Wszystkie powyższe narzędzia tylko odczytują dane.

Utwórz połączenie

Połączenie należy do Twojego konta, a nie do tenanta. Najpierw musisz skonfigurować weryfikację dwuetapową (e-mailem lub aplikacją uwierzytelniającą).

1. Otwórz ustawienia profilu, wybierz kartę Połączenia MCP i kliknij Utwórz.
2. Wpisz nazwę, wybierz zakres (domyślnie Tylko odczyt) i ważność w dniach (domyślnie 90, maksymalnie 365).
3. Wpisz 6-cyfrowy kod potwierdzający z metody weryfikacji dwuetapowej. Jeśli używasz weryfikacji e-mailem, najpierw kliknij Wyślij kod potwierdzający.
4. Skopiuj klucz dostępu. Jest wyświetlany tylko raz i zaczyna się od mcp_sk_.

Możesz mieć do 10 aktywnych połączeń.

Połącz aplikację AI

Serwer działa pod adresem https://app.monochat.ai/api/mcp-server (użyj własnego adresu MonoChat, jeśli uruchamiasz MonoChat na własnych serwerach) i oczekuje klucza dostępu jako tokena bearer w nagłówku Authorization.

Claude Code

claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
  --header "Authorization: Bearer <access key>"

Cursor

Dodaj serwer do ~/.cursor/mcp.json:

{
  "mcpServers": {
    "monochat": {
      "url": "https://app.monochat.ai/api/mcp-server",
      "headers": { "Authorization": "Bearer <access key>" }
    }
  }
}

Każdy inny klient MCP obsługujący transport streamable HTTP i własne nagłówki łączy się w ten sam sposób.

Limity

Wywołania są liczone na minutę: 60 na połączenie, 300 na konto i 600 na tenanta, a jednocześnie maksymalnie 4 wywołania na połączenie. Niektóre narzędzia liczą się jako więcej niż jedno wywołanie. Gdy limit zostanie osiągnięty, serwer odpowiada statusem 429 i nagłówkiem Retry-After; aplikacja AI powinna poczekać tyle sekund.

Unieważnij połączenie

Każde połączenie na karcie Połączenia MCP pokazuje status, zakres, ważność i ostatnie użycie. Kliknij Unieważnij, aby natychmiast odciąć aplikację AI. Unieważnionego lub wygasłego połączenia nie można ponownie użyć; utwórz nowe.

Zarządzanie dostępem MCP organizacji

Użytkownicy, którzy mogą zmieniać ustawienia organizacji, zarządzają jej dostępem MCP w Ustawienia › Organizacja › Serwer MCP.

• Wyłącz dostęp MCP dla tej organizacji: włącz i kliknij Zapisz, aby odrzucać każde wywołanie MCP do tej organizacji, z każdego połączenia każdego użytkownika. Organizacja przestaje się pojawiać w list_tenants. Wyłącz i zapisz, aby ponownie zezwolić na dostęp MCP.
• Wywołania MCP: każde wywołanie narzędzia wskazującego tę organizację, od najnowszych, łącznie z odrzuconymi. Każdy wiersz pokazuje użytkownika, połączenie, narzędzie, status (Sukces lub Niepowodzenie), adres IP i czas. Wywołania użytkowników, którzy nie są członkami tej organizacji, nie są wyświetlane.