Model Context Protocol

Il server MCP di ConnectMachine

ConnectMachine offre un server MCP remoto: qualsiasi strumento IA compatibile può gestire contatti, eventi, reti e biglietti digitali con una normale conversazione. Nulla da installare: lo strumento si collega via HTTPS con la tua chiave personale.

Incluso negli account ConnectMachine. Alcune azioni avanzate seguono le stesse regole Premium della app.

Cosa espone il server

Il server pubblica 40 strumenti. Il tuo assistente sceglie quello giusto per ogni richiesta; non li richiami mai per nome.

Contatti (12): elenco, ricerca, creazione, aggiornamento, eliminazione, ricerca intelligente, settori, duplicati, unione e reti.
Eventi (3): elenca i tuoi eventi e aggiungi o rimuovi l'evento in cui hai conosciuto un contatto.
Reti (5): elenco, creazione, aggiornamento, eliminazione e riordino.
Biglietti digitali (7): gestione completa, biglietto condiviso ed estrazione dati da una foto.
Import ed export (6): sessioni di import in blocco, avanzamento ed export CSV.
Notifiche e profilo (7): notifiche, contatori, profilo e abbonamento.

Importante

Gli strumenti di query IA e trascrizione riunioni arriveranno in una fase successiva.

Ottieni la tua chiave MCP

La chiave è un token personale legato al tuo account. Apri la pagina di connessione MCP, accedi con la tua email (codice monouso) o con Google e copia la chiave con le configurazioni già pronte. Tienila segreta; per revocarla, generane una nuova.

Pagina di connessione: licenses.connectmachine.ai/mcp/auth
Ogni richiesta del tuo strumento IA viene autenticata con questa chiave solo sul tuo account.

Collega Claude

Claude supporta i server MCP remoti su web, app desktop e Claude Code.

Claude web e desktop: Impostazioni > Connettori > Aggiungi connettore personalizzato con https://mcp.connectmachine.ai/mcp.
Claude Code: claude mcp add --transport http connectmachine https://mcp.connectmachine.ai/mcp --header "Authorization: Bearer LA_TUA_CHIAVE".
Client con JSON: aggiungi il server in mcpServers con l'url e l'header Authorization: Bearer.

Collega Cursor

Crea o modifica .cursor/mcp.json nel progetto (o il globale ~/.cursor/mcp.json) aggiungendo la voce connectmachine in mcpServers con l'url del server e l'header Authorization con la chiave. Ricarica Cursor e gli strumenti compaiono.

Importante

URL del server: https://mcp.connectmachine.ai/mcp

Collega VS Code

VS Code usa un oggetto servers invece di mcpServers. Crea .vscode/mcp.json con una voce di tipo "http", l'url del server e l'header Authorization. La pagina di connessione genera questo file esatto.

Altri client MCP

Qualsiasi client che supporti server MCP remoti si collega con due valori: l'URL del server e la chiave come token bearer. I client che implementano il flusso OAuth di MCP possono anche accedere dal browser: il server supporta OAuth 2.0 con registrazione dinamica e PKCE.

URL del server: https://mcp.connectmachine.ai/mcp
Header: Authorization: Bearer LA_TUA_CHIAVE

Come si comportano gli strumenti

Il server è progettato perché un assistente non possa sbagliare in silenzio con la tua rete.

Nomi uguali: se due contatti condividono il nome, find_contact segnala l'ambiguità e chiede all'assistente di domandare a te invece di indovinare.
Eventi, non tag: si registra l'evento in cui vi siete conosciuti, come nella app.
La ricerca copre nome, azienda, ruolo, email, telefono, note, posizione ed eventi.
Account nuovi: finché non completi l'onboarding nella app, gli strumenti rispondono con indicazioni e link di download.

Piani e azioni Premium

Collegare il tuo strumento IA è incluso. Le azioni Premium della app restano Premium via MCP, come l'export CSV e i filtri per settore o posizione. Un account gratuito riceve un messaggio chiaro con la funzione e come fare l'upgrade, mai un errore silenzioso.

Privacy e sicurezza

Il server MCP è un ponte leggero e autenticato verso le API di ConnectMachine. Non conserva copie della tua rete.

La chiave viene validata sul tuo account a ogni richiesta; nessun accesso tra account.
L'assistente riceve solo i dati necessari alla richiesta specifica.
Revoca in qualsiasi momento: genera una nuova chiave o elimina la configurazione.
Termini e privacy: connectmachine.ai/it/legal/terms-of-service e connectmachine.ai/it/legal/privacy.

Risoluzione dei problemi

La maggior parte dei problemi riguarda URL, chiave o stato dell'account.

Chiave non valida o scaduta: accedi di nuovo alla pagina di connessione e usa la chiave nuova.
Messaggio di onboarding: completa l'onboarding nella app e riprova.
Messaggio Premium: l'azione richiede un piano superiore; tutto il resto continua a funzionare.
Connessione fallita: verifica che l'URL sia esattamente https://mcp.connectmachine.ai/mcp e riavvia lo strumento dopo ogni modifica.