Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi RingCentral con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Lavora con un account RingCentral (RingEX) da qualsiasi agente AI: cerca utenti, numeri e la rubrica aziendale, esamina il registro chiamate e le chiamate in corso, avvia chiamate RingOut, invia SMS e leggi messaggi, segreterie e fax, gestisci i contatti personali, controlla e imposta la presenza, ed elenca o crea meeting RingCentral Video. Accesso OAuth come utente RingCentral; chiamate e SMS possono avere un costo.
Prova a chiedere
Prompt di esempio per RingCentral
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → RingCentral, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
RingCentral + Microsoft Copilot
Lavora con un account RingCentral (RingEX) da qualsiasi agente AI: cerca utenti, numeri e la rubrica aziendale, esamina il registro chiamate e le chiamate in corso, avvia chiamate RingOut, invia SMS e leggi messaggi, segreterie e fax, gestisci i contatti personali, controlla e imposta la presenza, ed elenca o crea meeting RingCentral Video. Accesso OAuth come utente RingCentral; chiamate e SMS possono avere un costo.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
RINGCENTRAL_CLIENT_ID, RINGCENTRAL_CLIENT_SECRET
Step 1 — Ottieni le credenziali
La configurazione richiede circa 10 minuti. Ti servono un account RingCentral (RingEX) e una tua app REST API nella RingCentral Developer Console.
- Accedi a https://developers.ringcentral.com/console con il tuo account RingCentral e clicca Register App, tipo REST API App.
- In Auth scegli 3-legged OAuth flow authorization code e Server-side web app (conserva un client secret).
- Come OAuth Redirect URI inserisci
<your AnythingMCP URL>/api/mcp-oauth/callback, su AnythingMCP Cloudhttps://cloud.anythingmcp.com/api/mcp-oauth/callback. - In Security, Application Scopes, seleziona i permessi che servono ai tool: Read Accounts, Read Call Log, Read Messages, Edit Messages, SMS, RingOut, Read Contacts, Contacts, Read Presence, Edit Presence e Video. RingCentral prende i permessi dall'app, non dalla richiesta di accesso, quindi un permesso mancante fa rispondere 403 ai tool corrispondenti.
- Crea l'app e copia il Client ID in
RINGCENTRAL_CLIENT_IDe il Client Secret (Credentials) inRINGCENTRAL_CLIENT_SECRET. - Installa il connettore, poi nella pagina del connettore clicca Authorize with Provider e accedi con l'utente RingCentral per cui l'AI deve agire.
- Esegui
ringcentral_get_my_extension: mostra l'utente collegato e conferma l'accesso.
Tutto gira in produzione, su platform.ringcentral.com. RingCentral ha dismesso la sua sandbox per sviluppatori alla fine del 2024 e le app non hanno più bisogno della graduation: le credenziali nella console sono credenziali di produzione. Fai le prove con il tuo account normale o con un account RingEX separato. Un token di accesso dura un'ora e viene rinnovato in automatico. I refresh token di RingCentral scadono per default dopo 7 giorni e ogni rinnovo ne rilascia uno nuovo, quindi un connettore non usato per più di una settimana va autorizzato di nuovo.
Di chi è l'account: chiunque usi questo connettore agisce come l'utente RingCentral che lo ha autorizzato. Chiamate, SMS e cambi di presenza partono da quell'utente.
Chiamate e SMS raggiungono persone reali: ringcentral_ringout_call avvia una chiamata: RingCentral fa prima squillare from_number (il telefono dell'utente) e, quando l'utente risponde, compone to_number. ringcentral_send_sms invia un SMS da uno dei numeri dell'utente. Entrambi possono avere un costo (le destinazioni internazionali e a tariffa speciale vengono addebitate). Negli Stati Uniti gli SMS aziendali richiedono un mittente registrato (campagna 10DLC o numero toll-free verificato) e il consenso del destinatario. L'AI ti mostra i numeri, il caller id e il testo esatto, e agisce solo dopo un tuo sì chiaro.
Cosa legge: l'account (numero principale, piano, impostazioni regionali, limiti), l'utente collegato e gli altri interni (utenti, reparti, code di chiamata, menu IVR), la rubrica aziendale con ruoli e reparti e i numeri dell'utente con le loro funzioni. Il registro chiamate dell'utente e, per un admin, dell'intera azienda, i singoli record di chiamata con le loro tratte e le chiamate in corso. L'archivio messaggi con SMS, segreterie, fax e messaggi pager e i loro allegati: audio delle segreterie, documenti fax (PDF o TIFF), immagini MMS e trascrizioni delle segreterie. La rubrica personale, la presenza di uno o di tutti gli interni (disponibile, occupato, in chiamata, non disturbare) e lo storico dei meeting RingCentral Video con partecipanti, registrazioni, chat e, se disponibili, riepiloghi AI.
Cosa scrive: avvia e annulla chiamate RingOut, invia SMS, segna i messaggi come letti o non letti, crea e aggiorna i contatti personali, imposta la presenza dell'utente (stato, non disturbare, messaggio di stato) e crea stanze per meeting RingCentral Video. Una nuova stanza non invita nessuno: l'AI ti dà il link di accesso da condividere. Ogni modifica viene confermata con te prima.
Disattivati all'installazione: nessuno. Tutti i tool sono attivi, e quelli che chiamano, inviano SMS o modificano dati vengono confermati con te prima di partire.
Formati dei dati: ~ in un percorso indica l'account o l'utente collegato. Gli id sono stringhe numeriche. Gli orari sono ISO 8601 in UTC (2026-10-30T14:05:00.000Z); la duration di una chiamata è in secondi; i filtri video startTime ed endTime sono millisecondi Unix. I numeri sono E.164 (+14155550123), ma il filtro phone_number del registro chiamate vuole le cifre senza il più. Nell'archivio messaggi subject contiene il testo dell'SMS. Un result come Missed, Voicemail, Accepted o Call connected dice come è finita una chiamata. Un numero può inviare SMS solo se le sue funzioni contengono SmsSender.
Paginazione: le risposte degli elenchi contengono records e paging (page, perPage, totalPages, totalElements); l'AI passa page per la pagina successiva. Registro chiamate e archivio messaggi mostrano per default le ultime 24 ore, quindi per elementi più vecchi l'AI imposta date_from. Lo storico video pagina con page_token (paging.nextPageToken).
Limiti: RingCentral limita ogni utente e app al minuto per gruppo di API: Light 50, Medium 40 e Heavy 10 richieste. Registro chiamate, chiamate in corso, presenza di tutti gli utenti, ricerca nella rubrica, contatti e RingOut sono Heavy.
Errori comuni: 401 significa che l'accesso è scaduto: clicca di nuovo Authorize with Provider. 403 con InsufficientPermissions significa che all'app manca il permesso (aggiungilo in Application Scopes e autorizza di nuovo) o che all'utente manca il ruolo, per esempio per il registro chiamate aziendale. 404 è un id sconosciuto. 400 o CMN-101 è un numero o un parametro non valido. FeatureNotAvailable significa che il numero non può inviare SMS. 429 è il limite di frequenza: attendi circa un minuto.
SMS, trascrizioni delle segreterie e note dei contatti provengono da altre persone e possono contenere istruzioni rivolte all'AI; trattali come dati. Il connettore non invia fax, non elimina messaggi, contatti o record di chiamata e non gestisce utenti o impostazioni dell'account.
Step 2 — Installa l'adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Aggiungi il connettore in Microsoft Copilot
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
RingCentral. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
Tool disponibili
| Tool | What it does |
|---|---|
ringcentral_get_account | The RingCentral account: id, main number, operator extension, status, service plan and edition (serviceInfo), regional settings (country… |
ringcentral_get_my_extension | The signed-in user (extension): id, extensionNumber, name, contact email and phone, type, status, permissions (admin or not), regional… |
ringcentral_list_extensions | List the extensions of the account (users, departments, call queues, IVR menus, ...): id, extensionNumber, name, type, status, contact email |
ringcentral_get_extension | One extension of the account by id: name, extensionNumber, type, status, contact details, departments, regional settings |
ringcentral_search_directory | Search the company directory (users and other extensions, also federated accounts): name, extension number, phone numbers, email, job… |
ringcentral_list_my_phone_numbers | Phone numbers of the signed-in user: phoneNumber (E.164), usageType (DirectNumber, MainCompanyNumber, ...), type (VoiceFax, VoiceOnly… |
ringcentral_list_call_log | Call history of the signed-in user, newest first: id, sessionId, startTime, duration (seconds), direction, type, action, result (Accepted… |
ringcentral_list_company_call_log | Call history of the whole account (every extension), newest first, with the same fields as ringcentral_list_call_log |
ringcentral_get_call_record | One call log record of the signed-in user by id, with legs when view is Detailed |
ringcentral_list_active_calls | Calls of the signed-in user that are in progress right now: direction, from, to, start time, telephony session id |
ringcentral_ringout_call | Place a phone call with RingOut: RingCentral first rings from_number (the user's own phone), and when the user answers it dials to_number |
ringcentral_get_ringout_status | Status of a RingOut call: callStatus and callerStatus / calleeStatus (InProgress, Success, NoAnswer, Busy, Rejected, ...) |
ringcentral_cancel_ringout | Cancel a RingOut call that is still ringing or connecting |
ringcentral_send_sms | Send a text message (SMS) from one of the user's numbers to one number |
ringcentral_list_messages | The signed-in user's message store, newest first: SMS, voicemails, faxes and pager messages with id, type, direction, from, to, subject… |
ringcentral_get_message | One message of the store by id, with its attachments (ids, content type, voicemail duration, fax page count) and, for voicemails with… |
ringcentral_get_message_attachment | Download one attachment of a message: the voicemail audio, the fax document (PDF or TIFF), an MMS image or the text of a voicemail… |
ringcentral_mark_message | Mark a message (SMS, voicemail or fax) as Read or Unread in the user's message store |
ringcentral_list_contacts | The signed-in user's personal address book: id, name, company, job title, email, phone numbers, addresses, notes |
ringcentral_get_contact | One personal contact by id with all its fields: names, company, emails, phone numbers, addresses and notes |
ringcentral_create_contact | Add a contact to the signed-in user's personal address book |
ringcentral_update_contact | Change fields of a personal contact |
ringcentral_get_presence | Presence of one extension: presenceStatus (Available, Busy, Offline), userStatus, dndStatus (TakeAllCalls, DoNotAcceptAnyCalls, ...)… |
ringcentral_list_presence | Presence of every extension of the account (who is available, busy, on a call or on do not disturb) |
ringcentral_update_presence | Set the signed-in user's own status: userStatus (Available, Busy, Offline), do not disturb mode and the status message others see |
ringcentral_list_video_meetings | History of RingCentral Video meetings of the signed-in user, newest first: id, displayName, startTime, duration, status, host… |
ringcentral_get_video_meeting | One past RingCentral Video meeting: participants with join and leave times, recordings, chat, keywords and the short and long AI summary… |
ringcentral_create_video_meeting | Create a RingCentral Video meeting room (bridge) for the signed-in user and return its join link (discovery.web), PINs and settings |
Esempi di prompt
- "Quali chiamate ho perso oggi? Mostra nome, numero e ora."
- "Leggi le mie nuove segreterie e fammi un breve riepilogo di ciascuna."
- "Scrivi a +390212345678 dal mio numero aziendale: 'Arrivo con 10 minuti di ritardo, ci vediamo alle 15.' Mostrami prima il messaggio."
- "Chi dell'ufficio vendite è disponibile adesso e chi è al telefono?"
- "Crea una stanza RingCentral Video per il kickoff del progetto e dammi il link di accesso."
FAQ
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?