# 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. 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.

```json
{
  "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.

```json
{
  "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.

```json
{
  "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.

```json
{
  "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.