Servidor MCP

El servidor MCP de graph8 conecta agentes de codificación con IA (Claude Code, Cursor, Windsurf, Claude Desktop) a su espacio de trabajo de graph8. Expone herramientas para búsqueda de contactos, gestión de campañas, instalación de fragmentos de seguimiento y generación de formularios progresivos, todo desde su IDE.

Configuración personal vs. de administrador

La mayoría de los usuarios deben utilizar la configuración MCP personal desde el Perfil. No necesita acceso de administrador de la organización.

Caso de uso	Dónde configurarlo	Credencial
MCP personal en Claude Desktop, Cursor, Windsurf, Claude Code	Perfil -> Desarrollador	Clave API personal (para local) u OAuth (para remoto)
Automatización de organización compartida e integraciones gestionadas por el administrador	Configuración -> API	Clave API de la organización

Configuración

Hay dos formas de conectarse: Remota (recomendada) y Local. La conexión remota utiliza OAuth: no requiere clave API ni instalación. La conexión local ejecuta el servidor en su máquina mediante stdio.

Remota (OAuth), recomendada

Pegue esta configuración en su cliente de IA. Su cliente le solicitará iniciar sesión mediante OAuth la primera vez que se conecte. No se necesita clave API.

Vaya a Customize > Connectors > Add custom connector
Pegue la URL del servidor: https://be.graph8.com/mcp/
Haga clic en Add y luego en Connect
Autorice cuando se le solicite (una sola vez)

Vaya a Settings > MCP Servers > Add
Pegue la URL del servidor: https://be.graph8.com/mcp/
Autorice cuando se le solicite (una sola vez)

Añada a ~/.claude/mcp.json:

{
  "mcpServers": {
    "graph8": {
      "url": "https://be.graph8.com/mcp/"
    }
  }
}

Añada a .cursor/mcp.json en la raíz de su proyecto:

{
  "mcpServers": {
    "graph8": {
      "url": "https://be.graph8.com/mcp/"
    }
  }
}

Añada a su configuración MCP de Windsurf:

{
  "mcpServers": {
    "graph8": {
      "url": "https://be.graph8.com/mcp/"
    }
  }
}

Vaya a Settings > Apps > Developer Mode
Añada el servidor MCP y pegue: https://be.graph8.com/mcp/
Autorice mediante OAuth

Guías de configuración

Elija su cliente. Cada guía cubre las variantes de OAuth remoto y stdio local.

Cursor

Cursor IDE con OAuth remoto o stdio local. Abrir guía

Claude Desktop

La aplicación de escritorio de Anthropic con clave API personal o de organización. Abrir guía

Claude Code

El agente de terminal de Anthropic mediante ~/.claude/mcp.json. Abrir guía

VS Code

MCP nativo mediante .vscode/mcp.json para el modo Copilot Agent. Abrir guía

n8n

Automatización de flujos de trabajo mediante el nodo MCP o solicitud HTTP. Abrir guía

LangChain

langchain-mcp-adapters + LangGraph para agentes en Python. Abrir guía

LlamaIndex

llama-index-tools-mcp para agentes Python tipados. Abrir guía

CrewAI

MCPServerAdapter para equipos multiagente. Abrir guía

Pydantic AI

Salidas de agente tipadas con MCPServerHTTP y MCPServerStdio. Abrir guía

OpenAI Agents SDK

MCP nativo mediante MCPServerStreamableHttp. Abrir guía

Ejemplos de extremo a extremo

Seis flujos de trabajo completos que encadenan herramientas MCP. Abrir guía

Qué puede preguntar

Patrones de prompts en lenguaje libre y flujos de trabajo compatibles. Abrir guía

Claude Desktop (MCP local)

Utilice Claude Desktop cuando quiera las herramientas de graph8 directamente dentro de la aplicación de escritorio con MCP local y su clave API personal.

Vaya a Perfil -> Desarrollador
Copie la configuración MCP local para el modo que desee (gtm, dev o all)
Péguela en la configuración MCP de Claude Desktop
Reinicie Claude Desktop

Para un recorrido paso a paso, consulte la guía de configuración de Claude Desktop.

Claude.ai (Actions)

Claude.ai utiliza acciones basadas en el navegador en lugar de MCP local.

Genere una clave API personal en Perfil -> Desarrollador
Utilice las acciones OpenAPI de graph8 con autenticación Bearer
Llame a las API de graph8 desde Claude.ai usando sus credenciales personales

Utilice esta opción cuando desee búsqueda de cuentas en el navegador, inteligencia de empresas y acciones de flujo de trabajo sin ejecutar un servidor MCP local.

ChatGPT (Actions)

ChatGPT también utiliza acciones basadas en el navegador en lugar de MCP local.

Genere una clave API personal en Perfil -> Desarrollador
Importe el OpenAPI de graph8 en su GPT o capa de acciones
Autentíquese con Bearer auth usando su clave API personal

Esta es la mejor opción para investigación de cuentas, búsqueda de contactos y elaboración de secuencias en flujos de trabajo del navegador con ChatGPT.

Local (stdio)

Si prefiere ejecutar el servidor localmente (o su cliente no admite MCP remoto), utilice el transporte stdio. Esto requiere Python 3.10+ y una clave API.

Reemplace <your-api-key> con:

su clave API personal de Perfil -> Desarrollador (recomendada para usuarios finales), o
una clave API de organización de Configuración -> API (integraciones de administrador o compartidas).

Developer Mode
GTM Mode

Para desarrolladores en Cursor, Windsurf o Claude Code:

{
  "mcpServers": {
    "graph8": {
      "command": "uvx",
      "args": ["g8-mcp-server"],
      "env": {
        "G8_API_KEY": "<your-api-key>",
        "G8_MCP_MODE": "dev"
      }
    }
  }
}

Para gestores de campañas en Claude Desktop:

{
  "mcpServers": {
    "graph8": {
      "command": "uvx",
      "args": ["g8-mcp-server"],
      "env": {
        "G8_API_KEY": "<your-api-key>",
        "G8_MCP_MODE": "gtm"
      }
    }
  }
}

uvx ejecuta el servidor directamente desde PyPI sin instalarlo. Si prefiere instalarlo de forma permanente, utilice pip install g8-mcp-server, aunque esto es principalmente para la CLI.

Variables de entorno (solo local)

Variable	Requerida	Predeterminado	Descripción
`G8_API_KEY`	Sí	—	Su clave API personal (Perfil) o clave API de organización (Configuración -> API) (detalles)
`G8_MCP_MODE`	No	`all`	Conjunto de herramientas a cargar: `dev`, `gtm` o `all`
`G8_API_URL`	No	`https://be.graph8.com`	URL base de la API (para instancias propias o entornos de prueba)

Modos

La variable G8_MCP_MODE controla qué herramientas se cargan. Esto aplica solo a conexiones locales (stdio); las conexiones remotas cargan todas las herramientas.

Modo Desarrollador (`dev`)

Para desarrolladores que crean productos en Cursor, Windsurf o Claude Code. Proporciona herramientas con alcance de repositorio para analizar bases de código, instalar seguimiento, generar formularios y gestionar campañas.

Establecer: G8_MCP_MODE=dev

Modo GTM (`gtm`)

Para gestores de campañas y operaciones de marketing en Claude Desktop. Proporciona herramientas con alcance de organización para crear campañas, explorar contenido de la base de conocimiento y ejecutar prospección, sin necesidad de contexto de repositorio.

Establecer: G8_MCP_MODE=gtm

Modo All (predeterminado)

Carga todas las herramientas heredadas para compatibilidad con versiones anteriores. Si no establece G8_MCP_MODE, este es el modo predeterminado.

Establecer: G8_MCP_MODE=all (o no incluya la variable)

Alcance de conjunto de herramientas en la URL remota (próximamente)

Actualmente, el endpoint OAuth remoto https://be.graph8.com/mcp/ carga todas las herramientas que su rol permite. El alcance por conjunto de herramientas está en la hoja de ruta para que distintos clientes puedan cargar solo las herramientas que necesitan:

https://be.graph8.com/mcp/?mode=dev - cargar solo las 17 herramientas de desarrollador
https://be.graph8.com/mcp/?mode=gtm - cargar solo las 23 herramientas GTM
https://be.graph8.com/mcp/?groups=audience-sync,inbox - cargar grupos de herramientas específicos

Esto forma parte de la hoja de ruta, aún no está disponible. Utilice G8_MCP_MODE en stdio mientras tanto.

Herramientas disponibles

Para la referencia completa por herramienta (parámetros, formatos de respuesta, ejemplos JSON, advertencias), consulte la Referencia de herramientas MCP. Las tablas a continuación son un índice rápido.

Herramientas de plataforma (todos los modos)

Disponibles en todos los modos: operaciones principales de contactos y empresas.

Herramienta	Descripción
`g8_search_contacts`	Buscar contactos que ya están en su CRM
`g8_search_companies`	Buscar empresas que ya están en su CRM
`g8_find_contacts`	Buscar en el índice de datos abiertos de 300M+ de graph8 para nuevos prospectos (consume créditos)
`g8_find_companies`	Buscar en el índice de datos abiertos de graph8 para nuevas empresas (consume créditos)
`g8_lookup_person`	Enriquecer una sola persona: devuelve el perfil completo (1 crédito)
`g8_lookup_company`	Enriquecer una sola empresa: devuelve datos firmográficos (1 crédito)
`g8_create_contact`	Crear un contacto en su CRM
`g8_enrich_contacts`	Enriquecer contactos existentes del CRM con datos de terceros (consume créditos)
`g8_get_lists`	Listar listas de contactos y empresas
`g8_create_list`	Crear una lista vacía de contactos o empresas
`g8_add_to_list`	Añadir contactos existentes a una lista
`g8_build_contact_list`	Buscar y guardar prospectos que coincidan en una nueva lista (consume créditos)
`g8_get_deals`	Listar oportunidades con filtros de etapa o pipeline
`g8_get_deal`	Obtener una sola oportunidad
`g8_get_pipeline`	Listar pipelines y etapas de oportunidades
`g8_get_tasks`	Listar tareas con filtros
`g8_create_task`	Crear una tarea vinculada a un contacto
`g8_get_activities`	Listar actividades recientes del CRM
`g8_create_note`	Añadir una nota a un contacto
`g8_list_sequences`	Listar secuencias outbound
`g8_add_to_sequence`	Añadir un contacto a una secuencia de prospección

Gestión de secuencias (todos los modos)

Control completo del ciclo de vida de las secuencias de prospección.

Herramienta	Descripción
`g8_create_sequence`	Crear una nueva secuencia con pasos, canales y programación
`g8_get_sequence_preview`	Previsualizar los pasos y canales de una secuencia antes de iniciarla
`g8_update_sequence`	Actualizar el nombre, la descripción o los indicadores de una secuencia
`g8_update_sequence_step`	Actualizar un solo paso (plantilla, temporización, canal)
`g8_pause_sequence`	Pausar una secuencia activa (sin nuevos envíos hasta que se reanude)
`g8_resume_sequence`	Reanudar una secuencia pausada
`g8_get_sequence_analytics`	Obtener métricas de rendimiento (tasa de respuesta, finalización, interacción)
`g8_delete_sequence`	Archivar una secuencia (eliminación lógica)

Bandeja de entrada y respuestas (todos los modos)

Gestione hilos de respuesta por correo electrónico, SMS y LinkedIn desde una superficie unificada.

Herramienta	Descripción
`g8_list_inbox`	Listar hilos de respuesta, filtrables por canal, secuencia, estado, responsable o etiqueta
`g8_get_reply`	Obtener un solo hilo de respuesta con el historial completo de mensajes
`g8_assign_reply`	Asignar un hilo de respuesta a un miembro del equipo
`g8_tag_reply`	Etiquetar un hilo de respuesta para su categorización
`g8_get_reply_draft`	Generar un borrador de respuesta con IA basado en el contexto de la conversación (consume créditos)
`g8_send_reply`	Enviar una respuesta por correo electrónico, SMS o LinkedIn

Audiencias y sincronización con CRM (todos los modos)

Envíe audiencias a plataformas publicitarias y sincronice contactos con CRMs.

Herramienta	Descripción
`g8_list_audience_syncs`	Listar las sincronizaciones de audiencias configuradas
`g8_create_audience_sync`	Crear una sincronización con Meta, LinkedIn Ads, Google Ads o X
`g8_get_audience_sync`	Obtener los detalles de configuración de una sincronización
`g8_update_audience_sync`	Actualizar la cadencia, el modo o las listas de supresión de una sincronización
`g8_delete_audience_sync`	Eliminar una configuración de sincronización (eliminación lógica)
`g8_trigger_audience_sync`	Activar manualmente una ejecución de sincronización
`g8_get_audience_sync_runs`	Ver el historial de ejecuciones de sincronización con recuentos de registros
`g8_get_audience_sync_errors`	Ver los registros de errores de ejecuciones de sincronización fallidas
`g8_list_crm_syncs`	Listar integraciones CRM conectadas (HubSpot, Salesforce, Pipedrive, Zoho, SugarCRM)
`g8_push_to_crm_contact`	Enviar contactos a un proveedor CRM
`g8_push_to_crm_company`	Enviar empresas a un proveedor CRM
`g8_push_to_crm_list`	Enviar membresías de listas a un proveedor CRM
`g8_get_crm_fields`	Descubrir los mapeos de campos disponibles para un proveedor CRM
`g8_get_crm_status`	Verificar el estado de la conexión CRM y los límites de velocidad

Herramientas de desarrollador (modo `dev`)

Herramientas con alcance de repositorio para integrar graph8 en su base de código.

Herramienta	Descripción
`g8_connect_repo`	Conectar un repositorio de GitHub/GitLab a graph8
`g8_scan_repo`	Activar un análisis de la base de código para puntos de integración GTM
`g8_get_scan_results`	Obtener los resultados del análisis (frameworks, páginas, componentes)
`g8_status`	Verificar el estado de integración del repositorio
`g8_doctor`	Diagnosticar problemas de estado de la integración
`g8_install_spine`	Generar un plan de instalación de seguimiento
`g8_apply_install`	Aplicar la instalación de seguimiento
`g8_list_campaigns`	Listar campañas de un repositorio
`g8_get_campaign`	Obtener detalles de una campaña
`g8_search_kb`	Buscar artículos en la base de conocimiento
`g8_list_kb_documents`	Listar todos los documentos de la base de conocimiento

Seguimiento y formularios (modo `dev`)

Instale el seguimiento JavaScript de graph8 y genere formularios progresivos.

Herramienta	Descripción
`g8_get_tracking_snippet`	Obtener el fragmento de seguimiento específico para cada framework (p.js). Compatible con: HTML, React, Next.js, Vue, WordPress, Webflow, Shopify
`g8_get_form_template`	Obtener la plantilla de formulario progresivo (embebido o emergente). Compatible con los mismos frameworks que el fragmento de seguimiento

Fragmento de seguimiento: lado del servidor vs. lado del cliente

El fragmento de seguimiento de graph8 (p.js) funciona de manera diferente según si su framework renderiza en el servidor o en el cliente. Comprender esto es fundamental para una instalación correcta.

Renderizado en el servidor (SSR)

Frameworks: Next.js, WordPress, Shopify, Webflow, HTML

El fragmento se incluye en el diseño HTML renderizado en el servidor (por ejemplo, app/layout.tsx, theme.liquid, functions.php). Se carga en cada página desde el primer renderizado, sin demora de hidratación.

// SSR — snippet is always available, call directly
g8.identify("user-123", { email: "[email protected]" });
g8.track("page_view", { page: "/pricing" });

Renderizado en el cliente (CSR)

Frameworks: React, Vue

El fragmento se inyecta mediante useEffect (React) o onMounted (Vue) después de la hidratación. Es posible que el script no esté listo de inmediato; utilice encadenamiento opcional para llamar a los métodos de seguimiento de forma segura.

// CSR — use optional chaining since g8 loads after hydration
window.g8?.identify("user-123", { email: "[email protected]" });
window.g8?.track("button_click", { button: "signup" });

Opciones de privacidad

Añada estos atributos de datos a la etiqueta del script para controlar el comportamiento de privacidad:

Atributo	Valores	Descripción
`data-privacy-dont-send`	`"true"`	Desactiva las cookies y el envío de eventos
`data-privacy-user-ids`	`"true"`	Desactiva el almacenamiento de identificadores de usuario
`data-privacy-ip-policy`	`"keep"`, `"stripLastOctet"`, `"remove"`	Controla el manejo de la dirección IP
`data-init-only`	`"true"`	Inicializa el script sin enviar un evento de página

Verificación

Después de instalar el fragmento, verifique que funcione correctamente:

Abra la pestaña DevTools -> Network del navegador
Busque solicitudes a su host de seguimiento (/p.js)
En Console: window.g8 debe estar definido
Llame a g8.track('test_event'): debería ver una solicitud de red

Gestión de campañas (modo `gtm`)

Herramientas con alcance de organización para gestores de campañas, sin necesidad de contexto de repositorio.

Herramienta	Descripción
`g8_list_campaigns`	Listar todas las campañas de la organización
`g8_get_campaign`	Obtener los detalles y el estado de una campaña
`g8_get_campaign_document`	Obtener un documento de campaña (correos electrónicos, páginas de destino)
`g8_create_campaign`	Crear una nueva campaña con audiencia, canales y contenido
`g8_update_campaign`	Actualizar la configuración de una campaña
`g8_launch_campaign`	Iniciar una campaña (o realizar una ejecución de prueba)
`g8_search_kb`	Buscar en la base de conocimiento
`g8_list_kb_documents`	Listar documentos de la base de conocimiento

Recursos

Los recursos MCP proporcionan contexto de solo lectura que los agentes pueden incluir en los prompts.

URI del recurso	Descripción
`g8://repos`	Lista de repositorios conectados
`g8://repos/{repo_id}/scan`	Resultados del análisis de un repositorio
`g8://repos/{repo_id}/kb`	Documentos de la base de conocimiento para un repositorio
`g8://repos/{repo_id}/kb/{doc_id}`	Contenido de un documento de la base de conocimiento
`g8://repos/{repo_id}/campaigns`	Campañas de un repositorio
`g8://repos/{repo_id}/campaigns/{campaign_id}/brief`	Resumen de una campaña
`g8://contacts`	Resumen de una lista de contactos
`g8://companies`	Resumen de una lista de empresas

Plantillas de prompts

Prompts prediseñados para flujos de trabajo GTM comunes.

Prompt	Argumentos	Descripción
`gtm_setup`	`repo_url`	Flujo de trabajo de configuración completo: conectar, analizar, instalar, iniciar
`campaign_review`	`campaign_id`	Revisar y optimizar una campaña
`icp_refinement`	`feedback`	Refinar el perfil de cliente ideal a partir de los comentarios

Primeros pasos

Un flujo de trabajo típico de desarrollador con el servidor MCP:

Configurar: añada la configuración remota a su cliente de IA (sin instalación necesaria)
Conectar: pida a su agente que conecte su repositorio: “Conecta mi repositorio github.com/org/app”
Analizar: el agente analiza su base de código en busca de frameworks y puntos de integración
Instalar fragmento: “Instala el fragmento de seguimiento de graph8 para Next.js”
Configurar seguimiento: añada g8.identify() en el inicio de sesión y g8.track() en acciones clave
Añadir formularios: “Genera un formulario progresivo embebido para React”
Iniciar campañas: “Crea una campaña dirigida a usuarios en período de prueba”

¿Necesita ayuda?

Preguntas frecuentes sobre MCP - errores comunes, autenticación, múltiples organizaciones, seguridad, límites de velocidad
Ejemplos de extremo a extremo - seis flujos de trabajo completos que puede copiar
Documentación interactiva de Swagger - la misma superficie, expuesta como REST
Precios - nivel gratuito y costos de créditos