74 lines
2.2 KiB
Markdown
74 lines
2.2 KiB
Markdown
---
|
|
name: add-parallel
|
|
description: Add Parallel AI MCP tools to the current host-process Claude runner.
|
|
---
|
|
|
|
# Add Parallel AI Integration
|
|
|
|
Parallel AI는 현재 구조에서도 유효한 도구 연동입니다. 다만 예전 문서처럼 컨테이너를 수정하지 않고, Claude 러너의 MCP 설정만 바꿉니다.
|
|
|
|
## 1. API 키 준비
|
|
|
|
`PARALLEL_API_KEY`를 `.env`에 넣습니다.
|
|
|
|
```bash
|
|
PARALLEL_API_KEY=...
|
|
```
|
|
|
|
## 2. 환경 변수 전달
|
|
|
|
`src/agent-runner.ts`
|
|
|
|
- `.env`에서 `PARALLEL_API_KEY`를 읽도록 `readEnvFile([...])` 목록에 추가합니다.
|
|
- Claude 러너 child env에 `PARALLEL_API_KEY`를 넣습니다.
|
|
|
|
## 3. MCP 서버 등록
|
|
|
|
`runners/agent-runner/src/index.ts`
|
|
|
|
- `query({ options: { mcpServers } })`에 Parallel HTTP MCP 서버를 추가합니다.
|
|
- `allowedTools`에 `mcp__parallel-search__*`, `mcp__parallel-task__*`를 추가합니다.
|
|
|
|
구분은 이렇게 가져가는 편이 안전합니다.
|
|
|
|
- `parallel-search`: 빠른 검색, 저비용, 기본 허용
|
|
- `parallel-task`: 긴 조사 작업, 비용/시간이 더 큼, 명시적 승인 후 사용
|
|
|
|
## 4. 프롬프트 규칙 추가
|
|
|
|
`groups/global/CLAUDE.md` 또는 대상 그룹의 `CLAUDE.md`
|
|
|
|
아래 원칙을 문서화합니다.
|
|
|
|
- 빠른 사실 조회나 최신 정보 확인은 `parallel-search`
|
|
- 긴 조사나 깊은 분석은 `parallel-task`
|
|
- `parallel-task`는 항상 먼저 사용자 허가를 받을 것
|
|
- 오래 걸리는 작업은 답변을 붙잡고 있지 말고 `mcp__nanoclaw__schedule_task`로 후속 체크를 맡길 것
|
|
|
|
## 5. 빌드와 검증
|
|
|
|
```bash
|
|
npm run build:runners
|
|
npm run build
|
|
npm run setup -- --step service
|
|
```
|
|
|
|
디스코드 테스트 예시:
|
|
|
|
> `최신 AI 뉴스 찾아줘`
|
|
|
|
> `AI 에이전트 역사 자세히 조사해줘`
|
|
|
|
두 번째 요청에서는 비용/시간 안내 후 허가를 먼저 묻게 만드는 게 맞습니다.
|
|
|
|
## 문제 확인
|
|
|
|
### MCP가 안 뜸
|
|
|
|
- `PARALLEL_API_KEY`가 child env까지 전달되는지 확인합니다
|
|
- `allowedTools`에 Parallel prefix가 빠지지 않았는지 봅니다
|
|
|
|
### 긴 작업이 응답을 오래 붙잡음
|
|
|
|
- `parallel-task` 결과를 기다리며 블로킹하지 말고 스케줄러로 넘기도록 프롬프트와 구현을 같이 수정합니다
|