Il server MCP di ConnectMachine

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.

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. Le chiavi sono gestite dal backend e non scadono; tienila segreta e, per disconnettere, elimina la configurazione dallo strumento.

• 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. In Claude web e desktop: Impostazioni, poi Connettori, scegli Aggiungi connettore personalizzato e incolla l'URL del server. Per Claude Code, crea .mcp.json nella radice del progetto con lo snippet qui sotto (sostituisci YOUR_MCP_KEY con la tua chiave) e riavvia Claude Code.

{
  "mcpServers": {
    "connectmachine": {
      "type": "http",
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}

Collega Cursor

Crea o modifica ~/.cursor/mcp.json (globale) o .cursor/mcp.json in un progetto, incolla lo snippet qui sotto e sostituisci YOUR_MCP_KEY con la tua chiave. Ricarica Cursor e gli strumenti di ConnectMachine compaiono nella lista MCP.

{
  "mcpServers": {
    "connectmachine": {
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}

Collega VS Code

VS Code usa un oggetto servers invece di mcpServers. Crea .vscode/mcp.json nel tuo workspace, incolla lo snippet qui sotto e sostituisci YOUR_MCP_KEY con la tua chiave.

{
  "servers": {
    "connectmachine": {
      "type": "http",
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}

Collega Zed

Zed chiama context server i server MCP e supporta quelli remoti in modo nativo, quindi non c'è alcuna estensione da installare. Apri Impostazioni, poi AI e MCP Servers, fai clic su Add Server e scegli Add Remote Server, oppure incolla lo snippet qui sotto nel tuo settings.json di Zed. Senza header Authorization, Zed esegue il flusso OAuth standard di MCP e ti chiede di accedere al primo utilizzo; aggiungi un oggetto "headers" con la tua chiave se preferisci un token statico.

{
  "context_servers": {
    "connectmachine": {
      "url": "https://mcp.connectmachine.ai/mcp"
    }
  }
}

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.
• Disconnetti quando vuoi eliminando la configurazione dallo strumento.
• 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: accedi di nuovo alla pagina di connessione e usa la chiave mostrata.
• 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.