arcade-mcp MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

arcade new crea un servidor funcional en segundos
OAuth integrado para integraciones con terceros (Reddit, etc.)
Gestión de secretos por herramienta — sin desorden de variables de entorno
arcade configure integra con Claude Desktop, Cursor, VS Code

Demo en vivo

Cómo se ve en la práctica

arcade.replay ▶ listo

0/0

Instalar

Elige tu cliente

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

{
  "mcpServers": {
    "arcade": {
      "command": "uvx",
      "args": [
        "arcade-mcp"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "arcade": {
      "command": "uvx",
      "args": [
        "arcade-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "arcade": {
      "command": "uvx",
      "args": [
        "arcade-mcp"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "arcade": {
      "command": "uvx",
      "args": [
        "arcade-mcp"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "arcade",
      "command": "uvx",
      "args": [
        "arcade-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "arcade": {
      "command": {
        "path": "uvx",
        "args": [
          "arcade-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add arcade -- uvx arcade-mcp

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: arcade-mcp

Crear un servidor MCP funcional en menos de 5 minutos con Arcade

👤 Cualquiera que sea nuevo en desarrollo de MCP ⏱ ~15 min beginner

Cuándo usarlo: Nunca has construido un MCP y no quieres cablear el SDK manualmente.

Requisitos previos

uv — astral.sh/uv

Flujo

Instalar + crear

Ejecuta uv tool install arcade-mcp y luego arcade new my_server. Abre el proyecto generado.✓ Copiado

→ Proyecto con herramientas de ejemplo
Ejecutar localmente

Ejecuta uv run server.py y usa mcp tools (desde f/mcptools) para listar lo que se anuncia.✓ Copiado

→ Herramientas predeterminadas visibles
Configurar Claude Desktop

Ejecuta arcade configure claude para integrarlo.✓ Copiado

→ Configuración de Claude Desktop actualizada; el servidor aparece en el próximo lanzamiento

Resultado: Un MCP funcional en el que puedes iterar sin leer documentos de especificación.

Combinar con: mcptools

Construir una herramienta MCP que llame a una API protegida por OAuth

👤 Desarrolladores que integran SaaS de terceros ⏱ ~45 min advanced

Cuándo usarlo: Necesitas que Claude llame a Reddit/Linear/GitHub en nombre del usuario, no de tu servicio.

Requisitos previos

Aplicación OAuth registrada con el proveedor objetivo — Consola de desarrollo del proveedor

Flujo

Configurar OAuth en arcade.yaml

Configura Reddit OAuth según el ejemplo en el README de arcade.✓ Copiado

→ Proveedor OAuth registrado
Escribir la herramienta

Añade una herramienta get_saved_posts que use el token OAuth inyectado para llamar a la API de Reddit.✓ Copiado

→ Herramienta funciona después de que el usuario autoriza
Primera ejecución activa la autenticación

Llama a get_saved_posts desde Claude — arcade guía al usuario a través del flujo OAuth una vez.✓ Copiado

→ Token almacenado; llamadas posteriores no vuelven a solicitar

Resultado: Integraciones MCP con alcance de usuario sin que tengas que mantener credenciales.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

arcade + mcptools

Inspeccionar superficies de herramientas durante el desarrollo

Ejecuta herramientas mcp contra mi servidor arcade de desarrollo para verificar el esquema después de cada cambio.✓ Copiado

arcade + hyper

Comparar Python/Arcade vs WASM/hyper para la misma herramienta

Implementa la misma herramienta 'fetch_user' en Arcade y hyper-mcp; compara latencias.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar
arcade new <name>	project_name: str	Iniciar
arcade configure <client>	client: claude\|cursor\|vscode	Integrar con un cliente
arcade dev		Iteración local

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguno — es un framework
Tokens por llamada: Depende de las herramientas
Monetario: Gratuito, código abierto
Consejo: Usa alcances de secretos por herramienta en lugar de variables de entorno globales — más fácil de auditar después

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Almacén de secretos de Arcade; tokens OAuth mantenidos separados de secretos estáticos

Salida de datos: Lo que llamen tus herramientas

Resolución de problemas

Errores comunes y soluciones

comando arcade no encontrado después de la instalación

Asegúrate de que el bin de herramientas de uv esté en PATH: export PATH=$HOME/.local/share/uv/tools/bin:$PATH

Verificar: which arcade

Bucle de redireccionamiento OAuth

Falta de coincidencia de URL de devolución de llamada — debe coincidir exactamente con la URL registrada del proveedor, incluida la barra diagonal final

Esquema de herramienta no actualizado en el cliente

La mayoría de los clientes hacen caché; reinicia el cliente después de añadir o eliminar herramientas

Alternativas

arcade-mcp vs otros

Alternativa	Cuándo usarla	Contrapartida
Golf	Priorizas autenticación empresarial/telemetría sobre ergonomía de distribución	Más orientado al backend
FastMCP	MCP de un solo archivo, no se necesita OAuth	Trae tu propio todo más allá de lo básico
TS SDK direct	Tienda de TypeScript	Lenguaje diferente

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills