Parallel Task MCP

공식

심층 연구 및 배치 작업 수행

Parallel Task MCP(으)로 무엇을 할 수 있나요?

  • Start deep research — Ask for a detailed, sourced answer to a complex question via createDeepResearch, then track progress with getStatus.
  • Enrich a dataset — Use createTaskGroup to enrich a list of companies or inputs with a common output schema, including source URLs.
  • Retrieve results as Markdown — Fetch completed research or enrichment output using getResultMarkdown for analysis or inclusion in your work.
  • Monitor async jobs — Check whether a running research or enrichment job is still active with getStatus before retrieving results.

문서

Parallel

Parallel Task MCP

AI 어시스턴트를 위한 심층 리서치 및 데이터 보강.

질문을 리서치하거나 소규모 데이터셋을 보강한 뒤, 에이전트를 떠나지 않고 결과를 검색하세요. Parallel이 서비스를 호스팅하며, 이 저장소를 실행할 필요 없이 서비스를 이용할 수 있습니다.

Task MCP를 사용하려면 Parallel 계정과 인증이 필요합니다. 무료인 Search MCP와 달리, 리서치 또는 보강 작업을 생성하는 것은 유료입니다. 작업을 시작하기 전에 Task API 요금을 검토하세요.

설정 문서 · API 키 발급 · Task MCP 문서

수동 설정

클라이언트에 맞는 연결 방법 하나를 선택하세요. 이 엔드포인트에 대한 기존 연결이 있다면 중복 추가하지 말고 재사용하세요.

Claude Code

Parallel을 사용하려는 프로젝트에서 다음을 실행하세요:

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

새 Claude Code 세션을 시작하고 /mcp을 실행한 뒤, 브라우저에서 안내에 따라 Parallel 로그인을 완료하세요.

Codex

Codex를 실행하는 환경에서 API 키를 PARALLEL_API_KEY로 사용할 수 있게 설정한 후, 다음을 실행하세요:

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

새 Codex 세션을 시작하고 /mcp을 실행하여 연결을 확인하세요. 구성은 키 자체가 아닌 환경 변수를 참조합니다. API 키를 구성 파일에 커밋하거나 대화에 붙여넣지 마세요. OAuth를 사용하려면 Codex 설정 지침을 참조하세요.

Cursor, VS Code 및 기타 클라이언트

HTTP / Streamable HTTP 전송에 이 서버 URL을 사용하세요:

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

Cursor의 경우, 이를 MCP 구성에 병합하세요:

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

안내가 표시되면 Parallel 로그인을 완료하세요. 호환되는 OAuth 지원이 없는 클라이언트는 Authorization 헤더에 Bearer 토큰으로 Parallel API 키를 사용할 수 있습니다. 공유 파일에 키를 하드코딩하지 말고 클라이언트의 보안 자격 증명 설정을 사용하세요.

VS Code는 mcpServers이 아닌 최상위 servers 객체를 사용합니다. 구성 형식 및 인증 옵션에 대한 클라이언트별 설정 지침을 따르세요.

사용 가능한 도구

도구기능
createDeepResearch상세하고 출처가 포함된 답변이 필요한 질문에 대한 리서치 작업을 시작합니다.
createTaskGroup공통 출력 스키마를 사용하여 입력 목록에 대한 보강 작업을 시작합니다.
getStatus실행 또는 그룹이 여전히 활성 상태인지 확인합니다.
getResultMarkdown리서치 또는 보강 출력을 Markdown으로 검색합니다.

이 네 가지 도구가 사용 가능한지 확인하여 연결을 검증하세요. 설치 확인만을 위해 유료 작업을 시작할 필요는 없습니다.

사용해 보기

회사 리서치:

createDeepResearch을 사용하여 Parallel Web Systems(https://parallel.ai)을 리서치하세요. 제품, 대상 고객, 공개적으로 발표된 자금 조달을 포함한 회사 브리프를 작성하세요. 출처를 인용하고 확인할 수 없는 사항은 표시하세요.

회사 목록 보강:

createTaskGroup을 사용하여 다음 세 회사를 보강하세요: Parallel Web Systems(https://parallel.ai), Google(https://google.com), Apple(https://apple.com). 각 회사에 대해 공식 회사명, 웹사이트, 본사, 설립 연도, 한 문장 제품 설명을 한 행씩 반환하세요. 출처 URL을 포함하고 확인할 수 없는 필드는 비워 두세요.

리서치와 보강은 비동기적으로 실행됩니다:

  1. 작업을 한 번 시작하고 실행 또는 그룹 ID를 보관하세요.
  2. 다른 작업을 계속하면서 getStatus을 사용하여 진행 상황을 확인하세요.
  3. 완료되면 getResultMarkdown을 사용하여 출력을 검색하고 분석하세요.

클라이언트가 자동으로 계속 진행하지 않으면 후속 메시지에서 기존 작업을 확인하도록 요청하세요. 진행 상황 확인을 위해 새 작업을 만들지 마세요. 더 많은 예시는 워크플로 가이드를 참조하세요.

문제 해결

  • 도구가 없음: 새 에이전트 세션을 시작하고 MCP 연결 목록을 확인한 후 URL이 https://task-mcp.parallel.ai/mcp인지 확인하세요.
  • 인증 실패: 브라우저 로그인을 완료하거나 클라이언트가 유효한 API 키에 접근할 수 있는지 확인하세요. 위의 Codex 명령의 경우 PARALLEL_API_KEY이 Codex를 실행하는 환경에 있어야 합니다.
  • 크레딧 부족 / HTTP 402: 새 작업을 시작하기 전에 platform.parallel.ai에서 잔액을 확인하세요.
  • 결과 없음: getStatus으로 기존 ID를 확인하세요. 작업 시작은 완료를 기다리지 않습니다.
  • 여전히 문제가 있음: 문제 해결 가이드를 참조하거나 이슈를 등록하세요. 클라이언트, 버전, 오류 메시지를 포함하되 자격 증명과 비공개 작업 입력/출력은 제외하세요.

개인정보, 지원 및 보안

요청된 리서치 또는 보강을 실행하기 위해 작업 입력이 Parallel로 전송됩니다. 호스팅 서비스 사용은 고객 약관 및 개인정보 처리방침의 적용을 받습니다.

제품 지원은 support@parallel.ai로 문의하세요.

프록시 로컬 실행

이 저장소를 체크아웃하고 Node.js와 npm이 설치된 환경에서:

  1. npm install을 실행하세요.
  2. npx wrangler dev을 실행하고 계속 실행 상태로 두세요.
  3. 다른 터미널에서 npx @modelcontextprotocol/inspector을 실행하세요.
  4. Streamable HTTP를 사용하여 Inspector를 http://localhost:8787/mcp에 연결하세요.

로컬 프록시는 여전히 호스팅 서비스를 호출합니다. 인증과 작업 요금은 여전히 적용됩니다. 이는 오프라인 작업 실행기가 아닙니다.