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.
ImportanteLas 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. Mantenla en secreto; para revocarla, genera una nueva.
- 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.
- Claude web y escritorio: Ajustes > Conectores > Añadir conector personalizado con https://mcp.connectmachine.ai/mcp.
- Claude Code: claude mcp add --transport http connectmachine https://mcp.connectmachine.ai/mcp --header "Authorization: Bearer TU_CLAVE".
- Clientes con JSON: añade el servidor en mcpServers con la url y la cabecera Authorization: Bearer.
04 Conecta Cursor
Crea o edita .cursor/mcp.json en tu proyecto (o el global ~/.cursor/mcp.json) y añade la entrada connectmachine en mcpServers con la url del servidor y la cabecera Authorization con tu clave. Recarga Cursor y aparecerán las herramientas.
ImportanteURL del servidor: https://mcp.connectmachine.ai/mcp
05 Conecta VS Code
VS Code usa un objeto servers en lugar de mcpServers. Crea .vscode/mcp.json con una entrada de tipo "http", la url del servidor y la cabecera Authorization. La página de conexión genera este archivo exacto.
06 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
07 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.
08 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.
09 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.
- Revoca el acceso generando una clave nueva o borrando la configuración.
- Términos y privacidad: connectmachine.ai/es/legal/terms-of-service y connectmachine.ai/es/legal/privacy.
10 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 o caducada: vuelve a iniciar sesión en la página de conexión y usa la clave nueva.
- 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.