Parallel Task MCP

Parallel Task MCP

Pesquisa aprofundada e enriquecimento de dados diretamente do seu assistente de IA.

Pesquise uma pergunta ou enriqueça um pequeno conjunto de dados e recupere os resultados sem sair do seu agente. A Parallel hospeda o serviço; você não precisa executar este repositório para usá-lo.

O Task MCP requer uma conta Parallel e autenticação. Diferente do Search MCP gratuito, criar tarefas de pesquisa ou enriquecimento é cobrado. Revise os preços da Task API antes de começar.

Documentação de configuração · Obter uma chave de API · Documentação do Task MCP

Configuração manual

Escolha um método de conexão para o seu cliente. Reutilize uma conexão existente para este endpoint em vez de adicioná-lo duas vezes.

Claude Code

Execute isto no projeto onde você deseja usar o Parallel:

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

Inicie uma nova sessão do Claude Code, execute /mcp e complete o login na Parallel no seu navegador quando solicitado.

Codex

Disponibilize sua chave de API como PARALLEL_API_KEY no ambiente que inicia o Codex e execute:

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

Inicie uma nova sessão do Codex e execute /mcp para verificar a conexão. A configuração referencia a variável de ambiente, não a chave em si. Não envie chaves de API para arquivos de configuração nem as cole em uma conversa. Para OAuth, veja as instruções de configuração do Codex.

Cursor, VS Code e outros clientes

Use esta URL de servidor com transporte HTTP / Streamable HTTP:

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

Para o Cursor, mescle isto na sua configuração MCP:

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

Complete o login na Parallel quando solicitado. Clientes sem suporte compatível a OAuth podem usar uma chave de API Parallel como token Bearer no cabeçalho Authorization; use as configurações seguras de credenciais do cliente em vez de codificar a chave em um arquivo compartilhado.

O VS Code usa um objeto servers de nível superior, não mcpServers. Siga as instruções de configuração específicas do cliente para o formato de configuração e opções de autenticação.

Ferramentas disponíveis

Ferramenta	O que faz
createDeepResearch	Inicia um trabalho de pesquisa para uma pergunta que precisa de uma resposta detalhada e com fontes.
createTaskGroup	Inicia trabalhos de enriquecimento para uma lista de entradas usando um esquema de saída comum.
getStatus	Verifica se uma execução ou grupo ainda está ativo.
getResultMarkdown	Recupera a saída de pesquisa ou enriquecimento como Markdown.

Verifique a conexão confirmando que essas quatro ferramentas estão disponíveis. Você não precisa iniciar um trabalho pago apenas para verificar a instalação.

Experimente

Pesquise uma empresa:

Use createDeepResearch para pesquisar a Parallel Web Systems (https://parallel.ai). Escreva um resumo da empresa cobrindo seus produtos, clientes-alvo e financiamento anunciado publicamente. Cite suas fontes e sinalize qualquer coisa que você não puder verificar.

Enriqueça uma lista de empresas:

Use createTaskGroup para enriquecer estas três empresas: Parallel Web Systems (https://parallel.ai), Google (https://google.com) e Apple (https://apple.com). Retorne uma linha por empresa com o nome oficial, site, sede, ano de fundação e uma descrição de produto em uma frase. Inclua URLs das fontes e deixe em branco qualquer campo que você não puder verificar.

Pesquisa e enriquecimento são executados de forma assíncrona:

1. Inicie o trabalho uma vez e guarde o ID da execução ou do grupo.
2. Use getStatus para verificar o progresso enquanto continua outros trabalhos.
3. Quando concluído, use getResultMarkdown para recuperar e analisar a saída.

Se o seu cliente não continuar automaticamente, peça para verificar o trabalho existente em uma mensagem de acompanhamento. Não crie outro trabalho apenas para verificar o progresso. Veja o guia de fluxo de trabalho para mais exemplos.

Solução de problemas

• Ferramentas ausentes: inicie uma nova sessão de agente, verifique a lista de conexões MCP e confirme se a URL é https://task-mcp.parallel.ai/mcp.
• Falha na autenticação: complete o login no navegador ou verifique se o seu cliente pode acessar uma chave de API válida. Para o comando Codex acima, PARALLEL_API_KEY deve estar presente no ambiente que inicia o Codex.
• Créditos insuficientes / HTTP 402: verifique seu saldo em platform.parallel.ai antes de iniciar outra tarefa.
• Ainda sem resultados: verifique o ID existente com getStatus; iniciar um trabalho não espera a conclusão.
• Ainda travado: veja o guia de solução de problemas ou abra uma issue. Inclua seu cliente, versão e mensagem de erro, mas omita credenciais e entradas ou saídas privadas de tarefas.

Privacidade, suporte e segurança

As entradas das tarefas são enviadas à Parallel para executar a pesquisa ou o enriquecimento solicitado. O uso do serviço hospedado é regido pelos Termos do Cliente e pela Política de Privacidade.

Para suporte ao produto, entre em contato com support@parallel.ai.

Executando o proxy localmente

A partir de um checkout deste repositório, com Node.js e npm disponíveis:

1. Execute npm install.
2. Execute npx wrangler dev e deixe-o em execução.
3. Em outro terminal, execute npx @modelcontextprotocol/inspector.
4. Conecte o Inspector a http://localhost:8787/mcp usando Streamable HTTP.

O proxy local ainda chama o serviço hospedado. Autenticação e cobranças de tarefas ainda se aplicam; isto não é um executor de tarefas offline.