← Documentación de ConnectMachine

Model Context Protocol

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.

01

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.

02

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

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.

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

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.

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

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.

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

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.

Zed settings.json
{
  "context_servers": {
    "connectmachine": {
      "url": "https://mcp.connectmachine.ai/mcp"
    }
  }
}
07

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
08

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

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.

10

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

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.