Herramienta gratuita

Validador de configuración MCP para Gemini CLI

Pega tu configuración y mira qué hará Gemini CLI con ella en realidad. La mayoría de configuraciones MCP rotas son JSON válido, que es justo por lo que nada te avisa de que están mal.

Pega la configuración JSON. Quita antes el token si lo prefieres: las comprobaciones no lo necesitan.
Se ejecuta por completo en tu navegador. Nada de lo que pegues se sube, se guarda ni se registra.

Por fin conectado. Ahora enséñale a alguien qué hace.

Acertar con la configuración es la mitad aburrida. MCP Showcase toma el mismo servidor y produce un playground en vivo que tus clientes pueden probar, con documentación para cada herramienta.

Comienza gratis Explora el directorio de servidores MCP

Cómo funciona

link
Pega tu configuración

No se sube nada. La comprobación se ejecuta por completo en tu navegador.

play_circle
La leemos como la leería Gemini CLI

Clave raíz, clave de endpoint, tipo de transporte y los campos específicos que Gemini CLI trata de forma distinta a todos los demás.

checklist
Corrige lo que encuentre

Cada problema viene con lo que Gemini CLI espera en su lugar, así que es un cambio que puedes hacer y no un síntoma que buscar.

Por qué una configuración válida no hace nada igualmente

Casi todas las configuraciones MCP rotas son JSON válido. Los clientes ignoran las claves que no reconocen, así que un archivo con la clave raíz equivocada o el campo de endpoint equivocado se analiza limpiamente, Gemini CLI arranca con normalidad y no aparece ningún servidor. No hay ningún error que buscar. Ese silencio es lo que hace que estos fallos sobrevivan tanto tiempo.

Qué se comprueba para Gemini CLI

  • Clave raíz — Gemini CLI lee mcpServers. Cualquier otra cosa se analiza y se ignora.
  • Campo de endpoint — los servidores remotos deben usar httpUrl.
  • Forma de las entradas — cada servidor necesita o un comando que lanzar o un endpoint al que conectarse.
  • HTTP sin cifrar — se señala, porque cualquier token bearer enviado a ese servidor viaja sin cifrar.
  • Campos propios de Gemini CLI — ver abajo.

httpUrl y url significan transportes distintos

Gemini CLI distingue ambos: "httpUrl" es Streamable HTTP y "url" es HTTP+SSE. Usar "url" para un servidor de Streamable HTTP es un desajuste de transporte, y se manifiesta como una conexión que se abre y luego no lleva a ninguna parte, en vez de como un error claro.

Tu configuración no se sube

La comprobación se ejecuta por completo en tu navegador y no hace ninguna petición de red. Es deliberado y no accidental: las configuraciones MCP contienen tokens de API con frecuencia, y «pega tu configuración en esta web» es algo que es razonable rechazar. Puedes confirmarlo en la pestaña de red de tu navegador.

Si la configuración está bien pero el servidor está vacío

Entonces el problema ha salido del archivo. Un cliente que muestra el servidor pero ninguna herramienta está conectando y fallando en el handshake o en el transporte, no leyendo mal tu configuración. El MCP Inspector muestra en qué transporte responde el servidor y el registro de peticiones en bruto, y el MCP Server Tester reduce lo mismo a una lista de aprobado/fallo.

Herramientas relacionadas

Cuando conecta, empieza la parte difícil

Una configuración que funciona es lo mínimo. Lo que no hace es ayudar a nadie a entender para qué sirve tu servidor, y si publicas un servidor MCP, eso es lo que decide si alguien llega a configurarlo. MCP Showcase convierte el mismo endpoint en un playground en vivo con documentación por herramienta, de modo que evaluarlo cueste un clic en lugar de un archivo de configuración y un reinicio.

Preguntas frecuentes

Porque los clientes ignoran lo que no reconocen. Una configuración con la clave raíz equivocada, o con un endpoint remoto bajo el nombre de campo equivocado, se analiza perfectamente y da un cliente que no ve ningún servidor y no informa de nada. El silencio es aquí el modo de fallo normal.

Que la clave raíz sea la que lee Gemini CLI; que los servidores remotos usen el nombre de campo que espera Gemini CLI; que cada entrada tenga un comando o un endpoint; que nada se sirva por HTTP sin cifrar; y las particularidades que aplican en concreto a Gemini CLI.

No. Se analiza en tu navegador y nunca sale de tu máquina, algo que importa porque las configuraciones MCP contienen tokens de API con frecuencia. No se hace ninguna petición de red.

Depende por completo del cliente, y por eso pilla a tanta gente. Claude, Cursor, Windsurf y Cline usan mcpServers; VS Code usa servers; Zed usa context_servers; Codex CLI usa mcp_servers en TOML. El resultado de abajo nombra la que necesita Gemini CLI.

Entonces el problema está en el servidor y no en el archivo. Pasa el endpoint por el MCP Inspector para confirmar que completa un handshake y ver qué expone.

Más herramientas MCP gratuitas

MCP Inspector online

Pega la URL de un servidor MCP y mira todas las herramientas, recursos y prompts que expone, con esquemas completos y el registro de peticiones. Nada que instalar.
Probador de servidores MCP

Comprueba que tu servidor MCP funciona de verdad. Pega la URL y obtén un informe de aprobado/fallo sobre la conexión, el handshake, el transporte y las herramientas que anuncia.
Escáner de seguridad MCP

Antes de apuntar un agente a un servidor MCP, mira qué está pidiendo. Calificado de la A a la F en transporte, autenticación, indicios de tool poisoning y parámetros peligrosos.
Calculadora de tokens MCP

Las definiciones de herramientas se envían en cada petición, no una sola vez. Pega la URL de tu servidor MCP y descubre cuántos tokens son, cuáles pesan más y cuánto cuesta.
Ver todas las herramientas gratuitas