Parallel Task MCP
공식심층 연구 및 배치 작업 수행
Parallel Task MCP(으)로 무엇을 할 수 있나요?
- Start deep research — Ask for a detailed, sourced answer to a complex question via
createDeepResearch, then track progress withgetStatus. - Enrich a dataset — Use
createTaskGroupto 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
getResultMarkdownfor analysis or inclusion in your work. - Monitor async jobs — Check whether a running research or enrichment job is still active with
getStatusbefore retrieving results.
문서
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을 포함하고 확인할 수 없는 필드는 비워 두세요.
리서치와 보강은 비동기적으로 실행됩니다:
- 작업을 한 번 시작하고 실행 또는 그룹 ID를 보관하세요.
- 다른 작업을 계속하면서
getStatus을 사용하여 진행 상황을 확인하세요. - 완료되면
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이 설치된 환경에서:
npm install을 실행하세요.npx wrangler dev을 실행하고 계속 실행 상태로 두세요.- 다른 터미널에서
npx @modelcontextprotocol/inspector을 실행하세요. - Streamable HTTP를 사용하여 Inspector를
http://localhost:8787/mcp에 연결하세요.
로컬 프록시는 여전히 호스팅 서비스를 호출합니다. 인증과 작업 요금은 여전히 적용됩니다. 이는 오프라인 작업 실행기가 아닙니다.