← Volver al centro de ayuda

Conectar Siggmund a su asistente de IA (MCP)

Para qué sirve

El MCP (Model Context Protocol) es un estándar que permite a un asistente de IA, como Claude, consultar un servicio externo. Una vez conectado Siggmund, usted hace sus preguntas a su asistente y este va a leer sus mediciones de Siggmund para responder: cómo está, qué ha cambiado desde la semana pasada, quién le adelanta.

Con una clave de organización (shg_), el acceso es de solo lectura y está limitado a sus datos (el inicio de sesión con Google de claude.ai y ChatGPT, descrito más abajo, abre algo más). Su asistente no puede modificar nada en Siggmund, ni generar un informe, ni ver a otro cliente.

Dos formas de conectar Siggmund

  • Sin clave, con su cuenta de Google: desde claude.ai o ChatGPT. Añade Siggmund como conector e inicia sesión con Google, sin copiar nada. Cualquier miembro de una organización puede hacerlo, no solo los administradores.
  • Con una clave: para Claude Code, Claude Desktop, Cursor y otros clientes que se configuran con un comando o un archivo (secciones más abajo).

En claude.ai

  1. En claude.ai, abra Settings (Configuración), luego Connectors (Conectores) y elija Add custom connector (Añadir conector personalizado). Según su plan, esta opción puede estar reservada a los administradores de su espacio de Claude.
  2. Póngale el nombre «Siggmund» y la dirección https://mcp.siggmund.com/mcp, y confirme.
  3. Haga clic en Connect (Conectar). Se abre una ventana de Google: elija la cuenta de Google cuya dirección de correo es la de su acceso a Siggmund y acepte. Siggmund solo pide a Google su dirección de correo.
  4. En una conversación, active el conector de Siggmund y haga su pregunta.

En ChatGPT

  1. En ChatGPT, abra Settings (Configuración), luego Apps (o Connectors) y active el Developer mode (modo desarrollador) si ChatGPT lo pide para añadir un servidor MCP.
  2. Cree un conector: nombre «Siggmund», dirección del servidor MCP https://mcp.siggmund.com/mcp, autenticación OAuth.
  3. Guarde e inicie sesión con su cuenta de Google, como en claude.ai (paso 3 de arriba).
  4. En una conversación, añada Siggmund a las herramientas utilizadas y haga su pregunta.

Lo que conviene saber sobre el inicio de sesión con Google

  • Su acceso es el de su dirección de correo en Siggmund: ve los clientes que ve en la aplicación. Una cuenta de Google con otra dirección inicia sesión, pero no ve ninguna herramienta de Siggmund.
  • Lo que el asistente puede hacer: leer sus datos, producir un informe o una presentación y escribir a nuestro soporte. Solo ve los clientes de su propio acceso, nunca los de otro.
  • Un acceso retirado se corta al cabo de un minuto aproximadamente. Para desconectarse usted mismo, elimine el conector en claude.ai o ChatGPT.

Antes de empezar: crear una clave

Esta sección y las tres siguientes tratan de las conexiones con clave (Claude Code, Claude Desktop, Cursor). Desde claude.ai o ChatGPT no necesita ninguna clave: véase arriba.

Los administradores de la organización pueden crear una clave. Si no se siente cómodo con una terminal o un archivo de configuración, pase esta guía a la persona que gestiona sus herramientas.

  1. Abra Conexiones en el menú y después la sección Acceso MCP.
  2. Abra la tarjeta Claves de acceso MCP y dé un nombre a la clave, por ejemplo «Claude de María».
  3. Elija su duración: 1 día, 1 semana, 1 mes, 1 año o sin caducidad.
  4. Haga clic en Crear la clave y cópiela. Empieza por shg_.

La clave solo se muestra una vez. Siggmund no conserva su valor: si la pierde, cree otra.

Lo que necesita

  • La dirección del servidor: https://mcp.siggmund.com/mcp (si configuró la antigua dirección run.app, sigue siendo válida)
  • Su clave, transmitida en una cabecera HTTP: Authorization: Bearer shg_…

Sustituya shg_… por su clave en los ejemplos siguientes.

En Claude Code

En una terminal, ejecute:

Terminal
claude mcp add --transport http siggmund https://mcp.siggmund.com/mcp \
  --header "Authorization: Bearer shg_…"

Para que la conexión sirva en todos sus proyectos, añada --scope user antes de la dirección. Sin eso, solo vale para la carpeta actual.

Compruébelo después: claude mcp list debe mostrar siggmund con la mención «Connected». En Claude Code, el comando /mcp da el mismo estado. Un fallo con código 401 significa que la clave es incorrecta, está revocada o ha caducado.

En Claude Desktop

El menú Conectores de Claude Desktop no ofrece un campo para una clave. Se conecta, por tanto, Siggmund mediante el archivo de configuración, con el pequeño puente mcp-remote. Requiere que Node.js esté instalado.

  1. En Claude Desktop, abra Settings (Ajustes), pestaña Developer, y haga clic en Edit Config. Se abre el archivo claude_desktop_config.json. Se encuentra en ~/Library/Application Support/Claude/ en macOS y en %APPDATA%\Claude\ en Windows.
  2. Añada el bloque siggmund (conserve sus otros servidores, si los hay):
JSON
{
  "mcpServers": {
    "siggmund": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.siggmund.com/mcp",
        "--header",
        "Authorization:${SIGGMUND_AUTH}"
      ],
      "env": {
        "SIGGMUND_AUTH": "Bearer shg_…"
      }
    }
  }
}
  1. Guarde, cierre por completo Claude Desktop y vuelva a abrirlo.
  2. En el cuadro de entrada, abra el menú Conectores: siggmund debe aparecer con sus herramientas.

El espacio que falta después de Authorization: es intencionado: evita que Windows parta el valor en dos. La clave está en la entrada env, no en la línea de comandos.

En Cursor (u otro cliente compatible)

Cursor sabe enviar una cabecera directamente, sin puente. En el archivo ~/.cursor/mcp.json (para todos sus proyectos) o .cursor/mcp.json (para un proyecto):

JSON
{
  "mcpServers": {
    "siggmund": {
      "url": "https://mcp.siggmund.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SIGGMUND_KEY}"
      }
    }
  }
}

Defina la variable de entorno SIGGMUND_KEY con su clave (sin la palabra Bearer) y reinicie Cursor.

Para cualquier otro cliente MCP: elija un servidor remoto con transporte HTTP («Streamable HTTP»), indique la dirección anterior y añada la cabecera Authorization: Bearer shg_….

Preguntas que puede hacer

Su asistente elige por sí mismo la herramienta adecuada. Estas son preguntas que Siggmund sabe tratar hoy y lo que el asistente va a leer.

Usted preguntaLo que consulta el asistente
«¿En qué me miden?»Sus líneas de ingresos y sus puntos de entrada
«¿Cuál es mi puntuación en cada uno de mis puntos de entrada, motor por motor?»Sus indicadores: tasa de citación, preferencia, puntuación
«¿Quién va delante de mí en ChatGPT en esta línea de ingresos?»La clasificación de sus competidores por motor
«¿Qué ha cambiado desde la última medición?»El resumen de la semana: sus mediciones, los competidores, los sitios más o menos citados
«¿Qué sitios citan las IA cuando se les habla de mi mercado?»Los sitios y las páginas citados: los suyos, los de sus competidores o los de terceros
«¿Cómo estaba el mes pasado?»La lista de sus mediciones pasadas y después la medición de la fecha deseada
«¿Qué reprochan los compradores a mis precios?»Las respuestas de las IA y las opiniones de compradores simulados
«¿Cómo ha entendido Siggmund mi actividad?»Su ficha: oficio, líneas de ingresos, preocupaciones de reputación
«¿Qué significa la puntuación de recomendabilidad?»Las definiciones de Siggmund
«¿Qué dice la investigación sobre cómo las IA eligen sus fuentes?»La biblioteca de estudios sobre GEO

También puede pedir una tabla cruzada de sus cifras (por ejemplo «ordena mis puntos de entrada de menor a mayor puntuación»): el asistente consulta entonces directamente sus datos.

Lo que el MCP no hace con una clave de este tipo: producir un informe o una presentación, escribir a nuestro soporte, modificar su cuenta.

Seguridad

  • La clave solo se muestra una vez. Cópiela en su herramienta en cuanto aparezca. No se puede recuperar ni se envía por correo electrónico.
  • No la comparta ni la pegue en un documento compartido, un correo electrónico o un repositorio de código. Una clave por persona o por herramienta permite cortar un acceso sin molestar a los demás.
  • Elija una duración corta si no necesita un acceso permanente. Una clave caducada se rechaza en la siguiente llamada.
  • Revóquela en cualquier momento en Conexiones, sección Acceso MCP, mediante el botón de revocación de la clave: el acceso se corta de inmediato. Hágalo en cuanto sospeche que se ha filtrado.
  • La clave de organización (shg_) solo da acceso a su organización, en solo lectura.

Si no funciona

  • 401 o «Failed to connect»: la clave está mal copiada, revocada o caducada. Compruebe la lista en Conexiones y cree una nueva si hace falta.
  • El servidor no aparece en Claude Desktop: ¿está instalado Node.js? ¿Cerró por completo la aplicación antes de volver a abrirla? El archivo de configuración debe ser JSON válido (comas, comillas).
  • Primera llamada lenta: el servicio puede tardar unos segundos en despertar. Vuelva a intentarlo.
  • El asistente no encuentra ninguna herramienta de Siggmund: compruebe que el servidor está activado en los ajustes de su asistente y pídale explícitamente que use Siggmund.
  • El inicio de sesión con Google falla o caduca (claude.ai, ChatGPT): el servicio puede tardar unos segundos en despertar y claude.ai se rinde al cabo de unos 10 segundos. Vuelva a iniciar la conexión.
  • Sesión iniciada, pero ninguna herramienta de Siggmund: la dirección de la cuenta de Google no es la de su acceso a Siggmund. Elimine el conector, vuelva a iniciar sesión con la dirección correcta o pida a un administrador que le añada en Miembros.

Última actualización: · Primera publicación: