Conectează aplicații AI (MCP)
MonoChat MCP Server permite unei aplicații AI care acceptă Model Context Protocol (MCP), precum Claude Code sau Cursor, să lucreze cu contul tău MonoChat. Aplicația AI cere date de la MonoChat printr-un set fix de instrumente și poate vedea doar ceea ce vezi și tu.
MonoChat MCP Server este disponibil în orice plan, fără limite în funcție de plan.
O aplicație AI conectată cu cheia ta de acces acționează ca utilizatorul tău. Ajunge la tenanții la care ai acces și la nimic altceva. Revocă conexiunile pe care nu le mai folosești.
Ce poate face aplicația AI
Aceste instrumente sunt disponibile pentru orice conexiune:
| Instrument | Ce face |
|---|---|
list_tenants | Listează tenanții la care are acces conexiunea. |
list_sessions | Listează sesiunile de conversație ale unui tenant, cele mai noi primele, opțional doar cele opened, assigned sau closed. |
get_session | Returnează o sesiune de conversație. |
list_messages | Listează mesajele unei sesiuni, cele mai noi primele. |
search_customers | Caută clienții unui tenant după un cuvânt-cheie. |
list_message_templates | Listează șabloanele de mesaje ale unui canal al unui tenant. |
Textul mesajelor provine de la clienți și agenți. Este date pe care aplicația AI le citește, nu instrucțiuni.
O conexiune are un domeniu, Doar citire sau Citire și scriere. O conexiune doar pentru citire nu vede niciodată instrumentele care modifică datele. Toate instrumentele de mai sus doar citesc.
Creează o conexiune
O conexiune aparține contului tău, nu unui tenant. Mai întâi trebuie să ai configurată verificarea în doi pași (prin e-mail sau cu o aplicație de autentificare).
- Deschide setările profilului, selectează fila Conexiuni MCP și apasă Creați.
- Introdu un nume, alege domeniul (implicit Doar citire) și valabilitatea în zile (implicit 90, maximum 365).
- Introdu codul de confirmare din 6 cifre al metodei tale de verificare în doi pași. Dacă folosești verificarea prin e-mail, apasă mai întâi Trimite codul de confirmare.
- Copiază cheia de acces. Este afișată o singură dată; începe cu
mcp_sk_.
Poți avea cel mult 10 conexiuni active.
Conectează o aplicație AI
Serverul se află la https://app.monochat.ai/api/mcp-server (folosește propria adresă MonoChat dacă rulezi MonoChat pe serverele tale) și așteaptă cheia de acces ca bearer token în antetul Authorization.
Claude Code
claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
--header "Authorization: Bearer <access key>"
Cursor
Adaugă serverul în ~/.cursor/mcp.json:
{
"mcpServers": {
"monochat": {
"url": "https://app.monochat.ai/api/mcp-server",
"headers": { "Authorization": "Bearer <access key>" }
}
}
}
Orice alt client MCP care acceptă transportul HTTP streamable și antete personalizate se conectează la fel.
Limite
Apelurile sunt numărate pe minut: 60 per conexiune, 300 per cont și 600 per tenant, iar o conexiune poate face cel mult 4 apeluri simultane. Unele instrumente se numără ca mai mult de un apel. Când se atinge o limită, serverul răspunde cu starea 429 și un antet Retry-After; aplicația AI trebuie să aștepte atâtea secunde.
Revocă o conexiune
Fiecare conexiune din fila Conexiuni MCP arată starea, domeniul, expirarea și ultima utilizare. Apasă Revocă pentru a tăia imediat accesul aplicației AI. O conexiune revocată sau expirată nu mai poate fi folosită; creează una nouă.
Gestionați accesul MCP al unei organizații
Utilizatorii care pot modifica setările unei organizații îi gestionează accesul MCP în Setări › Organizație › Server MCP.
- Dezactivează accesul MCP pentru această organizație: activați opțiunea și faceți clic pe Salvați pentru a refuza orice apel MCP către această organizație, de la orice conexiune a oricărui utilizator. Organizația nu mai apare în
list_tenants. Dezactivați opțiunea și salvați pentru a permite din nou accesul MCP. - Apeluri MCP: fiecare apel către un instrument care indică această organizație, de la cel mai recent, inclusiv apelurile refuzate. Fiecare rând arată utilizatorul, conexiunea, instrumentul, starea (Succes sau Eșuat), adresa IP și ora. Apelurile utilizatorilor care nu sunt membri ai acestei organizații nu sunt afișate.