CitedSpy

Conecta herramientas de IA como Claude, Cursor y Codex directamente a tu espacio de trabajo de CitedSpy con el Protocolo de Contexto de Modelo (MCP). Una vez conectado, tu asistente de IA puede leer tus marcas, prompts, ejecuciones, citas y análisis - y crear prompts o activar ejecuciones - sin que tengas que copiar datos de un lado a otro.

Lo que puedes hacer

• Consulta tu panel de visibilidad de IA en lenguaje natural
• Encuentra tus prompts y motores más débiles
• Crea y edita prompts de seguimiento desde el chat
• Activa nuevas ejecuciones en varios motores
• Trae citas, menciones e informes a tu flujo de trabajo de IA

Requisitos previos

• Una cuenta de CitedSpy en un plan con acceso a API (Growth o Pro)
• Una clave de API de CitedSpy
• Un cliente de IA compatible con MCP (Claude, Cursor, Codex, etc.)

La URL del servidor MCP de CitedSpy es:

https://mcp.citedspy.com/mcp

Paso 1 - Crea una clave de API

1. Inicia sesión en app.citedspy.com.
2. Ve a Configuración > Claves de API.
3. Haz clic en Nueva clave de API, asígnale un nombre (por ejemplo "Claude MCP") y copia la clave.

Tu clave comienza con cspy_ y solo se muestra una vez. Las claves de API están disponibles en los planes Growth y Pro.

Paso 2 - Conecta tu herramienta de IA

Elige tu herramienta a continuación. Cada herramienta apunta a la misma URL del servidor (https://mcp.citedspy.com/mcp) y termina con la misma autorización única en el Paso 3.

Claude Code (CLI)

Ejecuta esto en tu terminal:

claude mcp add --transport http citedspy https://mcp.citedspy.com/mcp

Luego inicia Claude Code, ejecuta /mcp, elige citedspy y autoriza.

Claude Desktop

1. Abre Configuración > Conectores > Agregar conector personalizado.
2. Nómbralo CitedSpy y pega la URL https://mcp.citedspy.com/mcp.
3. Haz clic en Agregar y luego en Conectar para autorizar.

Gemini CLI

Ejecuta:

gemini mcp add --transport http citedspy https://mcp.citedspy.com/mcp

Reinicia Gemini CLI, ejecuta /mcp y sigue el mensaje para autorizar citedspy. Si tu versión no tiene el comando mcp add, agrega el servidor a ~/.gemini/settings.json en su lugar:

{
  "mcpServers": {
    "citedspy": {
      "httpUrl": "https://mcp.citedspy.com/mcp"
    }
  }
}

Codex (CLI y Desktop)

Agrega esto a ~/.codex/config.toml:

[features]
experimental_use_rmcp_client = true

[mcp_servers.citedspy]
url = "https://mcp.citedspy.com/mcp"

Luego autoriza desde la terminal:

codex mcp login citedspy

La función rmcp_client es necesaria para servidores remotos que usan inicio de sesión (OAuth), como CitedSpy.

Cursor

Agrega el servidor a ~/.cursor/mcp.json (global) o .cursor/mcp.json (proyecto):

{
  "mcpServers": {
    "citedspy": {
      "url": "https://mcp.citedspy.com/mcp"
    }
  }
}

Cursor abre tu navegador para autorizar la primera vez que se usa el servidor.

Cualquier otro cliente MCP

Cualquier herramienta que admita servidores MCP remotos (HTTP transmisible) funciona. Agrega un nuevo servidor con la URL https://mcp.citedspy.com/mcp y completa la autorización en el Paso 3.

Paso 3 - Autoriza CitedSpy

La primera vez que te conectes, tu herramienta de IA abre una página de autorización de CitedSpy en tu navegador. Pega tu clave de API, confirma la conexión y regresa a tu herramienta de IA. CitedSpy valida la clave antes de que se cree la conexión y nunca la expone a la herramienta de IA. Solo haces esto una vez por herramienta.

Ejemplos de prompts

List all the brands in my CitedSpy workspace.

Show the visibility dashboard for my main brand over the last 30 days.

Create a comparison prompt for my brand against its top two competitors, then trigger a run.

Acciones disponibles

Acción	Qué hace
ping	Valida tu clave y muestra tu espacio de trabajo y plan
list_brands / get_brand	Lee marcas y sus competidores
list_prompts / get_prompt / get_prompt_report	Lee prompts e informes de análisis completos
create_prompt / update_prompt / delete_prompt	Gestiona prompts de seguimiento
list_runs / get_run / trigger_run	Lee ejecuciones y encola nuevas
list_competitors	Lee competidores de una marca
get_dashboard	Lee métricas calculadas del panel
list_citations / list_mentions	Lee citas y menciones detectadas
list_engines	Lee motores y tu selección de activado/desactivado
call_citedspy_v1	Llama a cualquier endpoint de API directamente

Seguridad

Tu clave de API autoriza el acceso MCP - trátala como una contraseña. El MCP puede crear, actualizar y eliminar prompts y activar ejecuciones, así que solo conecta herramientas de IA en las que confíes. Para revocar el acceso, desconecta el servidor en tu herramienta de IA o elimina la clave en Configuración > Claves de API.

Solución de problemas

"Clave de API no válida" - Copia la clave completa incluido el prefijo cspy_, sin espacios adicionales.

"El plan no incluye acceso MCP" - MCP requiere el plan Growth o Pro. Mejora tu plan y luego vuelve a conectarte.

La herramienta de IA no puede ver las acciones de CitedSpy - Confirma que la URL sea exactamente https://mcp.citedspy.com/mcp, luego desconecta y vuelve a conectar.

¿Necesitas ayuda? Contáctanos en citedspy.com/contact.