Saltearse al contenido

Configuración de Claude Desktop

Conecte Claude Desktop a graph8 Studio para consultar a Claude sobre sus campañas, cuentas e inteligencia comercial.

Requisitos previos

  • Claude Desktop instalado (descargar)
  • Una cuenta de graph8 Studio
  • Node.js instalado (para el cliente MCP)

Pasos de configuración

  1. Conéctese en graph8 Studio

    Vaya a Perfil y haga clic en “Connect” en la tarjeta MCP. Complete el flujo de inicio de sesión.

  2. Copie la configuración

    Una vez conectado, expanda “Setup Instructions” y seleccione la pestaña Claude Desktop. Copie la configuración JSON.

  3. Abra la configuración de Claude Desktop

    El archivo de configuración se encuentra en:

    ~/Library/Application Support/Claude/claude_desktop_config.json

    Cree el archivo si no existe.

  4. Agregue el servidor de G8 Studio

    Pegue la configuración que copió. Debería verse así:

    {
      "mcpServers": {
        "g8studio": {
          "command": "npx",
          "args": [
            "-y",
            "@anthropic-ai/mcp-client-sse",
            "https://mcp-production-c2f3.up.railway.app/mcp?session_id=YOUR_SESSION_ID"
          ]
        }
      }
    }

  5. Reinicie Claude Desktop

    Cierre y vuelva a abrir Claude Desktop para cargar la nueva configuración.

  6. Verifique la conexión

    Inicie una nueva conversación y pregunte: “¿Qué campañas tengo en G8 Studio?”

Preguntas de ejemplo

Una vez conectado, intente preguntarle a Claude:

Show me my active campaigns in G8 Studio
What accounts are in the healthcare industry?
Get the intelligence report for [account name]
Search G8 Studio for content about competitive positioning
What deals are in my pipeline?

Cómo funciona

Claude Desktop utiliza MCP (Model Context Protocol) para conectarse a graph8 Studio:

  1. Cuando usted menciona datos de G8 Studio, Claude reconoce que necesita información externa
  2. Claude invoca la herramienta de G8 Studio correspondiente (como list_campaigns o search)
  3. El servidor MCP se autentica con su sesión y obtiene los datos
  4. Claude da formato a los resultados y los presenta en la conversación

Solución de problemas

Aquí se cubren los detalles específicos de Claude Desktop. Los problemas genéricos de MCP (autenticación, permisos, análisis de JSON, “herramienta no encontrada”) se resuelven en las Preguntas frecuentes de MCP.

”MCP server failed to start”

  • Verifique que Node.js esté instalado: node --version
  • Ejecute el comando npx manualmente para ver los errores:
    Ventana de terminal
    npx -y @anthropic-ai/mcp-client-sse "https://mcp-production-c2f3.up.railway.app/mcp?session_id=TEST"

Claude no reconoce los comandos de graph8 Studio

  • Confirme que reinició Claude Desktop después de agregar la configuración (Cmd-Q en macOS, no basta con cerrar la ventana)
  • Compruebe que el archivo de configuración esté en la ubicación correcta para su sistema operativo (consulte los pasos de configuración anteriores)

Otros problemas

  • Sesión expirada o error de autenticación -> FAQ
  • Permiso denegado -> FAQ
  • Error de análisis JSON al iniciar -> FAQ
  • Herramienta no encontrada -> FAQ

Múltiples cuentas

Si tiene acceso a varias organizaciones de graph8, la IA utiliza la organización que estaba activa al momento de conectarse. Para cambiar de organización:

  1. Cambie de organización en graph8 Studio
  2. Cree una nueva conexión desde la página de Perfil
  3. Actualice su configuración con el nuevo ID de sesión
  4. Reinicie Claude Desktop

Gestión de sesiones

Las sesiones expiran tras 24 horas de inactividad. Cuando su sesión expire:

  1. Claude mostrará un error de autenticación
  2. Vaya a Perfil en graph8 Studio
  3. Haga clic en “Connect” para iniciar una nueva sesión
  4. Actualice su configuración con el nuevo ID de sesión
  5. Reinicie Claude Desktop

Privacidad y seguridad

  • Sus datos de graph8 se obtienen en tiempo real y Claude no los almacena
  • Todas las solicitudes utilizan su sesión autenticada
  • Puede revocar el acceso en cualquier momento desde la página de Perfil
  • Las llamadas a la API se registran con fines de auditoría

Preguntas frecuentes

¿Con qué frecuencia debo actualizar mi sesión?

Las sesiones expiran tras 24 horas de inactividad. Si utiliza graph8 a diario, su sesión se mantiene activa. Después de un fin de semana o de unas vacaciones, lo más probable es que deba reconectarse.

¿Puedo conectar varias organizaciones de graph8?

Cada sesión está vinculada a una sola organización. Para acceder a otra, cambie de organización en graph8 Studio, cree una nueva conexión y actualice su configuración con el nuevo ID de sesión.

¿Claude almacena mis datos de graph8?

No. Los datos se obtienen en tiempo real y Claude no los almacena. Cada consulta recupera datos actualizados de graph8 Studio. Al revocar su sesión, el acceso se interrumpe de inmediato.

¿Por qué Claude no reconoce mis preguntas sobre G8 Studio?

Confirme que reinició Claude Desktop después de agregar la configuración. Verifique que la sintaxis JSON sea válida (sin comas al final, comillas correctas). Compruebe que el ID de sesión esté vigente y no haya expirado.

¿Puedo usar esto junto con otros servidores MCP?

Sí. Agregue varios servidores al objeto mcpServers en su configuración. Cada servidor tiene su propio nombre de clave y Claude puede utilizar herramientas de todos los servidores configurados.

Relacionado