ForcedAlpha

Investigación de la cadena de suministro de carteras para agentes de IA: mapear dependencias, investigar exposiciones compartidas, rastrear shocks de suministro y descubrir puntos de estrangulamiento.

Servidor MCP alojado

npx add-mcp 'https://forcedalpha.com/mcp/'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Usa el grafo de la cadena de suministro en tu agente.

El Protocolo de Contexto de Modelos (MCP) permite que un cliente de IA llame a las herramientas del grafo de ForcedAlpha. Llama a tools/list y capabilities para obtener el manifiesto actual, las reglas de acceso y los límites.

Comienza con los archivos estáticos públicos: inspecciona la guía de inicio rápido y la instantánea con fecha antes de iniciar sesión. La instantánea no es una respuesta en vivo ni una evaluación anónima.

La dirección HTTP pública de transmisión es https://forcedalpha.com/mcp/. El mismo servicio también responde en https://mcp.forcedalpha.com/. Una ruta /mcp en ese subdominio aún no está activa.

Obtén una clave de API

Crea una cuenta gratuita o inicia sesión. Tu panel muestra tu clave de interfaz de programación de aplicaciones (API). MCP acepta un token de portador OAuth de un conector o una clave de API en el encabezado X-API-Key. OAuth es un flujo de inicio de sesión: tu cliente de IA te envía a ForcedAlpha para aprobar el acceso.

Ingresa tu correo electrónico y te enviamos un enlace de inicio de sesión que abre tu panel con tu clave de API; los correos nuevos obtienen una cuenta gratuita, sin necesidad de tarjeta ni contraseña.

Mantén la clave fuera de las URL y de los archivos de configuración compartidos. Un conector puede completar el flujo de autorización sin una clave en su URL.

Conéctate

Agrega https://forcedalpha.com/mcp/ como servidor MCP remoto en un cliente que admita HTTP de transmisión y OAuth. Inicia sesión o proporciona tu clave de API en la página de autorización de ForcedAlpha. Luego habilita el conector en una conversación y pregunta: "¿Lasertec suministra a TSMC?"

La dirección más antigua https://forcedalpha.com/mcp/sse sigue siendo una ruta heredada de eventos enviados por el servidor (SSE). Usa la dirección HTTP de transmisión para nuevas conexiones.

Claude

En la configuración de conectores de Claude, agrega un conector personalizado llamado ForcedAlpha con la URL https://forcedalpha.com/mcp/. Deja en blanco el ID de cliente OAuth y el secreto opcionales para que Claude pueda descubrir el flujo de autorización. Completa la página de aprobación de ForcedAlpha y luego habilita el conector en la conversación.

ChatGPT

En la configuración de conectores de ChatGPT, crea un conector MCP personalizado llamado ForcedAlpha. Establece la URL en https://forcedalpha.com/mcp/ y elige OAuth. Completa la página de autorización de ForcedAlpha y luego habilita el conector en el chat. No agregues una clave de API a la URL.

Claude Desktop

Configuración → Conectores → Agregar conector personalizado. Establece el nombre como ForcedAlpha y la URL como https://forcedalpha.com/mcp/. Deja en blanco el ID de cliente OAuth y el secreto. Completa la página de autorización de ForcedAlpha cuando se te solicite y luego habilita el conector en una conversación.

Claude Desktop: archivo de configuración (npx)

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Usa esta ruta solo si administras servidores MCP editando el archivo de configuración directamente en lugar de hacerlo a través de la interfaz de Conectores. Agrega una entrada forcedalpha dentro de mcpServers. mcp-remote conecta el transporte del archivo de configuración con el endpoint HTTP de transmisión del servidor y abre una ventana del navegador para la aprobación OAuth en la primera conexión. La configuración no necesita clave.

{
  "mcpServers": {
    "forcedalpha": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://forcedalpha.com/mcp/"
      ]
    }
  }
}

Reinicia Claude Desktop después de guardar. Para usar una clave de API en lugar del flujo del navegador OAuth (por ejemplo, en una máquina sin interfaz gráfica), agrega un argumento de encabezado en lugar de depender del paso del navegador:

{
  "mcpServers": {
    "forcedalpha": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://forcedalpha.com/mcp/",
        "--header",
        "X-API-Key:fa_YOUR_KEY_HERE"
      ]
    }
  }
}

Nunca pongas la clave en la URL. Una clave pasada como parámetro de consulta ?key= se escribe en los registros de acceso del servidor en texto plano. Pásala como encabezado, como se muestra arriba, o usa la ruta de Conectores OAuth en su lugar.

Si no funcionó

  • Sin ícono de herramienta después de reiniciar. Causa: error de sintaxis JSON en la configuración, o Node.js no está instalado. Acción: valida el JSON, confirma que node -v funciona en una terminal, cierra y reinicia completamente Claude Desktop.
  • La ventana del navegador no se abre para OAuth. Causa: mcp-remote abre un puerto local para la devolución de llamada de inicio de sesión, y un firewall puede bloquearlo. Acción: permite el puerto o cambia a la configuración de clave de API anterior.
  • Las llamadas a herramientas devuelven un error de autenticación con una clave nueva. Causa: la clave se escribió mal o no ha llegado al servidor. Acción: copia la clave nuevamente desde tu panel, reinicia Claude Desktop y, si aún falla, escribe a [email protected] antes de generar una segunda clave.

Claude Code

Claude Code (CLI)

Terminal. No hay archivo de configuración que editar.

Un solo comando, usando el flujo OAuth (abre un navegador para aprobar el acceso en el primer uso):

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

O con una clave de API, pasada como encabezado:

claude mcp add --transport http forcedalpha https://forcedalpha.com/mcp/ \
  --header "X-API-Key: fa_YOUR_KEY_HERE"

Verifica que se haya agregado:

claude mcp list

El servidor ahora está disponible en las sesiones de Claude Code en ese ámbito. Usa claude mcp remove forcedalpha para desconectarte.

Si no funcionó

  • Comando no encontrado, o la conexión falla de inmediato. Acción: confirma que estás en una versión de Claude Code que admita --transport http; las versiones anteriores solo admiten sse.
  • claude mcp list muestra el servidor pero las llamadas a herramientas fallan. Causa: la clave tiene un error tipográfico o no ha llegado al servidor, o la aprobación OAuth no se completó. Acción: elimina y vuelve a agregar el servidor con la clave copiada nuevamente; si aún falla, contacta al soporte.

Cursor

Cursor

.cursor/mcp.json en la raíz de tu proyecto, o ~/.cursor/mcp.json para configuración global

La configuración MCP de Cursor admite un tipo de servidor HTTP con encabezados directamente, por lo que no necesita el puente mcp-remote:

{
  "mcpServers": {
    "forcedalpha": {
      "url": "https://forcedalpha.com/mcp/",
      "headers": {
        "X-API-Key": "fa_YOUR_KEY_HERE"
      }
    }
  }
}

Reinicia Cursor después de guardar. Las herramientas aparecen en la lista de contexto de Composer. Si tu versión de Cursor no admite el campo headers, usa la configuración mcp-remote mostrada para Claude Desktop anteriormente, sustituida en .cursor/mcp.json.

Si no funcionó

  • Las herramientas no aparecen en Composer. Causa: archivo de configuración en la ubicación incorrecta o error de sintaxis JSON. Acción: confirma la ruta (la del nivel de proyecto tiene prioridad sobre la configuración global), valida el JSON y reinicia Cursor por completo.
  • Error de conexión justo después de la configuración. Causa: la clave tiene un error tipográfico o no ha llegado al servidor. Acción: copia la clave nuevamente, reinicia Cursor y contacta al soporte si aún falla.

Gemini CLI

Gemini CLI

~/.gemini/settings.json

{
  "mcpServers": {
    "forcedalpha": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://forcedalpha.com/mcp/",
        "--header",
        "X-API-Key:fa_YOUR_KEY_HERE"
      ]
    }
  }
}

Crea ~/.gemini/ si no existe. Inicia una nueva sesión de Gemini CLI después de guardar. Las herramientas se cargan cuando se inicia. Las sesiones existentes no detectan los cambios de configuración.

Si no funcionó

  • Las herramientas no se cargan al iniciar la sesión. Causa: error de sintaxis JSON o el archivo de configuración no está en la ubicación esperada. Acción: valida el JSON y confirma la ruta, luego inicia una sesión nueva.
  • Error de autenticación en la primera llamada a herramienta. Causa: la clave tiene un error tipográfico o no ha llegado al servidor. Acción: copia la clave nuevamente, inicia una sesión nueva y contacta al soporte si aún falla.

Herramientas y parámetros

Esta es una referencia con fecha del 30 de septiembre. En la columna de parámetros, los parámetros obligatorios van antes del punto y coma y los opcionales después. El tools/list en vivo es la autoridad; la respuesta capabilities establece reglas y límites de acceso adicionales.

HerramientaPropósitoParámetros
capabilitiesDescubre las herramientas activas, las reglas de acceso y los límitesnone
forcedalpha_queryEnruta una solicitud de grafo en lenguaje natural admitidaquery; selection, request_id, deadline_ms, option_token
forcedalpha_briefPunto de entrada de compatibilidad para una solicitud en lenguaje naturalquery; audience, mode
search_nodesEncuentra nodos candidatos del grafoquery; node_type, theme, severity_min, limit, detail
verify_edgeVerifica una relación dirigidafrom_id, to_id; relationship, product, material_form, temporal_scope, detail
verify_claimVerifica una afirmación de relación en inglés sencilloclaim
verify_pathVerifica una ruta ordenadapath_nodes; audience, direction
path_betweenEncuentra rutas desde un consumidor hacia un proveedor o material aguas arribafrom_id, to_id; k, max_hops, include_soft_signal, audience
screen_company_listExamina una lista ordenada de empresasentities; max_depth, dependency_scope, minimum_evidence_grade, require_source_url, include_rejected, shared_minimum_members, ledger_detail, audience, deadline_ms
portfolio_common_modeEncuentra dependencias directas compartidas entre participacionestickers; top_n, audience, mode, evidence, projection, detail
portfolio_xrayEncuentra rutas aguas arriba acotadas entre participacionestickers; max_hops, top_n, audience, mode, evidence, projection, detail
co_product_contagionRastrea el acoplamiento de oferta o demanda desde un subproductoseed_id; shock_type
trace_shockRastrea un impacto físico a través de rutas admitidas del grafoevent; portfolio, mode, audience, max_depth, evidence_filter, require_primary, target_domain, seed_node_ids, scenario_id
shock_briefConstruye un informe de impacto separado por evidenciaevent; portfolio, mode, audience, max_depth, evidence_filter, evidence_mode
watchlist_from_shockConstruye una lista de monitoreo a partir de un impactoevent; max_items, audience, evidence_mode
find_chokepointsEncuentra nodos del grafo de alta severidadtheme, severity_min, country, market_cap_max, theme_match
trace_dependencyRecorre dependencias desde un nodonode_id; direction, max_depth
find_customersEncuentra clientes de un nodonode_id; limit, theme, theme_match, audience, include_below_gate
find_critical_nodesClasifica rutas de restricción aguas arriba mapeadas desde el sidecar sellado; esta es una vista de cobertura mapeada, no una puntuación de centralidad o criticidad en el mundo realnone; rank_by, theme, severity_min, country, market_cap_max, limit, audience, theme_match, allowed_types, track
supply_chokepointsLista los puntos de estrangulamiento sellados de la Pista A en orden de sidecar; los dependientes aguas abajo están separados de los insumos, y la Pista B se omite con su motivonone; mode, target, track, limit

Las herramientas más antiguas ya no aparecen en la lista de herramientas. Un cliente que haya almacenado en caché una lista antigua recibe TOOL_CONTAINED si llama a una de ellas.

Ejemplos de indicaciones

Estas son cosas que puedes escribir en una conversación una vez que el conector esté habilitado. El cliente selecciona la herramienta y los parámetros correspondientes; no necesitas llamar a la herramienta por su nombre.

capabilities

"¿Qué puede decirme el grafo de ForcedAlpha y cuál es mi uso actual?"

forcedalpha_query / forcedalpha_brief

"Pregunta a ForcedAlpha: ¿Lasertec suministra a TSMC y qué evidencia respalda eso?"

search_nodes

"Busca en el grafo empresas del tema de IA con severidad 4 o superior."

verify_edge

"Verifica si LASERTEC suministra directamente a TSMC en el grafo."

verify_claim

"Verifica esta afirmación contra el grafo: 'Bloom Energy depende de membranas PEM.'"

verify_path

"Verifica esta ruta: NVDA a TSMC a galio. ¿Cada salto está conectado?"

path_between

"Encuentra la ruta desde NVDA aguas arriba hasta el galio en el grafo de la cadena de suministro."

screen_company_list

"Examina esta lista en busca de dependencias comunes aguas arriba: NVDA, AMD, AMAT, LRCX."

portfolio_common_mode

"¿Cuáles de estas participaciones comparten una dependencia directa aguas arriba: NVDA, AMD, AMAT?"

portfolio_xray

"Rastrea rutas aguas arriba en mi cartera: NVDA, AMD, TSM, AXTI."

co_product_contagion

"Si se interrumpe el suministro de mineral de galio, ¿qué efectos de subproducto o coproducto siguen?"

trace_shock

"China restringe las exportaciones de galio. Rastrea el impacto a través del grafo."

shock_brief

"Construye un informe sobre el impacto si China restringe las exportaciones de galio."

watchlist_from_shock

"Construye una lista de monitoreo de empresas expuestas si China restringe las exportaciones de galio."

find_chokepoints

"Encuentra puntos de estrangulamiento de severidad 4+ en el tema de IA con capitalización de mercado inferior a $10 mil millones."

trace_dependency

"¿De qué depende AXTI aguas arriba?"

find_customers

"¿Quiénes son los clientes aguas abajo de AXTI en el grafo?"

Grados de evidencia

Cada borde del grafo tiene un grado de confianza que describe cómo se verificó la evidencia detrás de él, no cuán importante es la relación:

A

B

C

D

A: la página fuente se obtuvo, se encontró una cita textual de al menos 40 caracteres en ella, ninguna verificación ha encontrado que la cita contradiga la afirmación o dirección del borde, y la fuente es un registro primario estricto: una presentación regulatoria, una presentación gubernamental o el sitio propio de la empresa.

B: hay una URL fuente archivada y existe una cita, pero la evidencia no alcanzó el estándar completo de A: la cita no se capturó o verificó por bytes aún, la fuente no es estrictamente primaria, o un borde de grado A decayó porque su fecha de fuente es antigua.

C: una banda de confianza media. El borde se informa desde una fuente, pero no se ha capturado una cita textual contra él.

D: confianza baja. Esto cubre bordes inferidos de la estructura del grafo, bordes que fallaron una verificación de dirección o afirmación, y bordes con fuente cuya confianza sigue siendo baja.

Aproximadamente un tercio de los bordes del grafo son primarios o con fuente directa hoy; el resto lleva un grado más bajo y está etiquetado como tal. Las herramientas de análisis MCP devuelven el grado de cada borde que citan. El grado no cambia cómo se responde una consulta: una búsqueda de puntos de estrangulamiento aún devuelve nodos coincidentes independientemente de los grados de sus bordes; verifica el grado en la evidencia específica en la que planeas confiar.

Planes

Free y Pro usan el mismo grafo y el mismo estándar de evidencia. Pro eleva los límites de volumen y añade recorrido descendente; no cambia lo que cuenta como verificado.

PlanAnálisis completos / mesSolicitudes / díaNotas
Free10500En MCP, las herramientas de verificación (verify_edge, verify_claim, verify_path) no cuentan contra la cuota mensual. El recorrido descendente es de Pro.
Pro~1,000Sin límite diarioSuperar el número de referencia mensual no bloquea solicitudes.
EnterprisePersonalizadoSin límite diarioRecorrido del grafo hasta profundidad 6. Contacta con ventas para los términos.

Estos límites se aplican por clave de API en el servidor MCP. Cada solicitud MCP también cuenta hacia un límite de 120 solicitudes por 60 segundos, en todos los planes. La misma clave funciona en la API REST, pero REST mantiene sus propios contadores y tiene sus propios límites por ruta, enumerados en la página de la API REST. Consulta precios para los precios actuales.

Evidencia y respuestas incompletas

Cada resultado lleva su evidencia donde existe: URL de origen, cita textual, calificación y estado de verificación. También indica lo que la respuesta no cubre. Una ruta marcada como en cuarentena o faltante no está verificada, así que no la reportes como una relación de suministro. Las herramientas de verificación devuelven su propio veredicto con la evidencia que lo respalda.

Límites y errores

Las cuentas Free tienen 10 análisis completos por mes calendario. Pro incluye alrededor de 1,000 consultas al mes, y superar esa cifra no bloquea solicitudes. El servicio también verifica 120 solicitudes por 60 segundos por clave y un límite diario de 500 solicitudes para Free; Pro y Enterprise no tienen límite diario en el servicio MCP. Llama a capabilities para conocer los límites actuales de cada herramienta.

Las negativas a nivel de herramienta usan un objeto con ok: false, code, message y retry, a veces con hint o detail. Un nodo desconocido puede usar UNKNOWN_ID con un veredicto de resolución adicional. Los fallos de inicio de sesión y de tasa se devuelven como errores HTTP. Un fallo de tasa o de límite diario devuelve HTTP 429 con un mensaje error. Una herramienta contenida devuelve TOOL_CONTAINED.