# El servidor MCP de ConnectMachine

ConnectMachine ofrece un servidor MCP remoto: cualquier herramienta de IA compatible puede gestionar tus contactos, eventos, redes y tarjetas digitales conversando. No hay nada que instalar; tu herramienta se conecta por HTTPS con tu clave personal.

✓Incluido con las cuentas de ConnectMachine. Algunas acciones avanzadas siguen las mismas reglas Premium que la app.

## Qué expone el servidor

El servidor publica 40 herramientas. Tu asistente elige la adecuada para cada petición; nunca las invocas por nombre.

- **Contactos (12)**: listar, buscar, crear, actualizar, eliminar, búsqueda inteligente, sectores, duplicados, fusión y redes.
- **Eventos (3)**: lista tus eventos y añade o quita el evento donde conociste a un contacto.
- **Redes (5)**: listar, crear, actualizar, eliminar y reordenar.
- **Tarjetas digitales (7)**: gestión completa, tarjeta compartida y extracción de datos desde una foto de tarjeta.
- **Importación y exportación (6)**: sesiones de importación por lotes, progreso y exportación CSV.
- **Notificaciones y perfil (7)**: notificaciones, contadores, perfil y suscripción.

**Importante**  
Las herramientas de consultas con IA y transcripción de reuniones llegarán en una fase posterior.

## Consigue tu clave MCP

La clave es un token personal vinculado a tu cuenta. Abre la página de conexión MCP, inicia sesión con tu correo (código de un solo uso) o con Google y copia la clave junto con las configuraciones listas para usar. Las claves se gestionan en el backend y no caducan; mantenla en secreto y elimina la configuración de tu herramienta para desconectar.

- Página de conexión: licenses.connectmachine.ai/mcp/auth
- Cada petición de tu herramienta de IA se autentica con esta clave solo contra tu cuenta.

## Conecta Claude

Claude admite servidores MCP remotos en la web, la app de escritorio y Claude Code. En Claude web y escritorio: Ajustes, luego Conectores, elige Añadir conector personalizado y pega la URL del servidor. Para Claude Code, crea .mcp.json en la raíz del proyecto con el fragmento de abajo (sustituye YOUR_MCP_KEY por tu clave) y reinicia Claude Code.

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

## Conecta Cursor

Crea o edita ~/.cursor/mcp.json (global) o .cursor/mcp.json dentro de un proyecto, pega el fragmento de abajo y sustituye YOUR_MCP_KEY por tu clave. Recarga Cursor y aparecerán las herramientas de ConnectMachine.

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

## Conecta VS Code

VS Code usa un objeto servers en lugar de mcpServers. Crea .vscode/mcp.json en tu espacio de trabajo, pega el fragmento de abajo y sustituye YOUR_MCP_KEY por tu clave.

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

## Conecta Zed

Zed llama context servers a los servidores MCP y admite los remotos de forma nativa, así que no hay extensión que instalar. Abre Ajustes, luego IA y MCP Servers, pulsa Add Server y elige Add Remote Server, o pega el fragmento de abajo en tu settings.json de Zed. Sin cabecera Authorization, Zed ejecuta el flujo OAuth estándar de MCP y te pide iniciar sesión la primera vez; añade un objeto "headers" con tu clave si prefieres un token estático.

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

## Otros clientes MCP

Cualquier cliente compatible con servidores MCP remotos se conecta con dos valores: la URL y tu clave como token bearer. Los clientes que implementan el flujo OAuth de MCP también pueden iniciar sesión desde el navegador (OAuth 2.0 con registro dinámico y PKCE).

- **URL del servidor**: https://mcp.connectmachine.ai/mcp  
- **Cabecera**: Authorization: Bearer TU_CLAVE

## Cómo se comportan las herramientas

El servidor está diseñado para que un asistente no pueda equivocarse en silencio con tu red.

- Nombres repetidos: si dos contactos comparten nombre, find_contact detecta la ambigüedad y pide al asistente que te pregunte en lugar de adivinar.
- Eventos, no etiquetas: se registra el evento donde conociste a la persona, igual que en la app.
- La búsqueda cubre nombre, empresa, cargo, correo, teléfono, notas, ubicación y eventos.
- Cuentas nuevas: hasta completar la incorporación en la app, las herramientas responden con orientación y enlaces de descarga.

## Planes y acciones Premium

Conectar tu herramienta de IA está incluido. Las acciones Premium de la app siguen siendo Premium por MCP, como la exportación CSV o los filtros por sector y ubicación. Una cuenta gratuita recibe un mensaje claro con la función y cómo actualizar, nunca un fallo silencioso.

## Privacidad y seguridad

El servidor MCP es un puente autenticado y ligero hacia la API de ConnectMachine. No guarda copia de tu red.

- La clave se valida contra tu cuenta en cada petición; no hay acceso entre cuentas.
- El asistente recibe solo los datos necesarios para tu petición.
- Desconecta cuando quieras borrando la configuración de tu herramienta.
- Términos y privacidad: connectmachine.ai/es/legal/terms-of-service y connectmachine.ai/es/legal/privacy.

## Solución de problemas

La mayoría de los problemas se deben a la URL, la clave o el estado de la cuenta.

- **Clave no válida**: vuelve a iniciar sesión en la página de conexión y usa la clave que muestra.
- **Mensaje de incorporación**: completa la incorporación en la app y vuelve a intentarlo.
- **Mensaje Premium**: esa acción requiere un plan superior; el resto sigue funcionando.
- **Fallo de conexión**: confirma que la URL es exactamente https://mcp.connectmachine.ai/mcp y reinicia tu herramienta tras cambiar la configuración.