Parallel Task MCP

Parallel Task MCP

Investigación profunda y enriquecimiento de datos desde tu asistente de IA.

Investiga una pregunta o enriquece un pequeño conjunto de datos, y recupera los resultados sin salir de tu agente. Parallel aloja el servicio; no necesitas ejecutar este repositorio para usarlo.

Task MCP requiere una cuenta de Parallel y autenticación. A diferencia del Search MCP gratuito, crear tareas de investigación o enriquecimiento es facturable. Revisa los precios de Task API antes de comenzar a trabajar.

Documentación de configuración · Obtén una clave API · Documentación de Task MCP

Configuración manual

Elige un método de conexión para tu cliente. Reutiliza una conexión existente a este endpoint en lugar de agregarlo dos veces.

Claude Code

Ejecuta esto en el proyecto donde quieras usar Parallel:

claude mcp add --transport http --scope project parallel-task https://task-mcp.parallel.ai/mcp

Inicia una nueva sesión de Claude Code, ejecuta /mcp y completa el inicio de sesión de Parallel en tu navegador cuando se te solicite.

Codex

Haz que tu clave API esté disponible como PARALLEL_API_KEY en el entorno que inicia Codex, luego ejecuta:

codex mcp add parallel-task --url https://task-mcp.parallel.ai/mcp \
  --bearer-token-env-var PARALLEL_API_KEY

Inicia una nueva sesión de Codex y ejecuta /mcp para verificar la conexión. La configuración hace referencia a la variable de entorno, no a la clave en sí. No comprometas claves API en archivos de configuración ni las pegues en una conversación. Para OAuth, consulta las instrucciones de configuración de Codex.

Cursor, VS Code y otros clientes

Usa esta URL de servidor con transporte HTTP / Streamable HTTP:

https://task-mcp.parallel.ai/mcp

Para Cursor, fusiona esto en tu configuración de MCP:

{
  "mcpServers": {
    "parallel-task": {
      "url": "https://task-mcp.parallel.ai/mcp"
    }
  }
}

Completa el inicio de sesión de Parallel cuando se te solicite. Los clientes sin soporte OAuth compatible pueden usar una clave API de Parallel como token Bearer en el encabezado Authorization; usa la configuración de credenciales seguras del cliente en lugar de codificar la clave en un archivo compartido.

VS Code usa un objeto servers de nivel superior, no mcpServers. Sigue las instrucciones de configuración específicas del cliente para su formato de configuración y opciones de autenticación.

Herramientas disponibles

Herramienta	Qué hace
createDeepResearch	Inicia un trabajo de investigación para una pregunta que necesita una respuesta detallada y con fuentes.
createTaskGroup	Inicia trabajos de enriquecimiento para una lista de entradas usando un esquema de salida común.
getStatus	Verifica si una ejecución o grupo sigue activo.
getResultMarkdown	Recupera la salida de investigación o enriquecimiento como Markdown.

Verifica la conexión comprobando que estas cuatro herramientas estén disponibles. No necesitas iniciar un trabajo de pago solo para verificar la instalación.

Pruébalo

Investiga una empresa:

Usa createDeepResearch para investigar Parallel Web Systems (https://parallel.ai). Escribe un informe de la empresa que cubra sus productos, clientes objetivo y financiamiento anunciado públicamente. Cita tus fuentes y señala cualquier cosa que no puedas verificar.

Enriquece una lista de empresas:

Usa createTaskGroup para enriquecer estas tres empresas: Parallel Web Systems (https://parallel.ai), Google (https://google.com) y Apple (https://apple.com). Devuelve una fila por empresa con su nombre oficial, sitio web, sede, año de fundación y una descripción de producto en una oración. Incluye URLs de fuentes y deja en blanco cualquier campo que no puedas verificar.

La investigación y el enriquecimiento se ejecutan de forma asíncrona:

1. Inicia el trabajo una vez y conserva su ID de ejecución o grupo.
2. Usa getStatus para verificar el progreso mientras continúas con otro trabajo.
3. Una vez completado, usa getResultMarkdown para recuperar y analizar la salida.

Si tu cliente no continúa automáticamente, pídele que verifique el trabajo existente en un mensaje de seguimiento. No crees otro trabajo solo para verificar el progreso. Consulta la guía de flujo de trabajo para más ejemplos.

Solución de problemas

• Faltan herramientas: inicia una nueva sesión de agente, verifica la lista de conexiones MCP y confirma que la URL sea https://task-mcp.parallel.ai/mcp.
• La autenticación falla: completa el inicio de sesión en el navegador, o verifica que tu cliente pueda acceder a una clave API válida. Para el comando de Codex anterior, PARALLEL_API_KEY debe estar presente en el entorno que inicia Codex.
• Créditos insuficientes / HTTP 402: verifica tu saldo en platform.parallel.ai antes de iniciar otra tarea.
• Aún sin resultados: verifica el ID existente con getStatus; iniciar un trabajo no espera su finalización.
• Sigue atascado: consulta la guía de solución de problemas o abre un problema. Incluye tu cliente, versión y mensaje de error, pero omite credenciales y entradas o salidas privadas de tareas.

Privacidad, soporte y seguridad

Las entradas de tareas se envían a Parallel para ejecutar la investigación o el enriquecimiento solicitado. El uso del servicio alojado se rige por los Términos del Cliente y la Política de Privacidad.

Para soporte de producto, contacta a support@parallel.ai.

Ejecutar el proxy localmente

Desde un checkout de este repositorio, con Node.js y npm disponibles:

1. Ejecuta npm install.
2. Ejecuta npx wrangler dev y déjalo en ejecución.
3. En otra terminal, ejecuta npx @modelcontextprotocol/inspector.
4. Conecta el Inspector a http://localhost:8787/mcp usando Streamable HTTP.

El proxy local aún llama al servicio alojado. La autenticación y los cargos por tareas siguen aplicándose; esto no es un ejecutor de tareas sin conexión.