MCP 서버 연동
MCP(Model Context Protocol) 서버를 연결하여 AI에게 외부 도구를 제공할 수 있습니다.
MCP(Model Context Protocol) 서버를 연결하여 AI에게 외부 도구를 제공할 수 있습니다.
설치
pip install clawops[mcp]
# 또는 agent와 함께
pip install clawops[agent,mcp]
mcp패키지 없이mcp_servers를 설정하면AgentError: MCP 서버를 사용하려면 pip install clawops[mcp] 를 실행하세요.에러가 발생합니다.
사용법
from clawops.agent import ClawOpsAgent, OpenAIRealtime
from clawops.agent.mcp import MCPServerHTTP, MCPServerStdio
agent = ClawOpsAgent(
from_="07012341234",
session=OpenAIRealtime(
system_prompt="상담원입니다.",
),
mcp_servers=[
# HTTP/SSE 기반 MCP 서버
MCPServerHTTP(
"https://my-mcp-server.com",
headers={"Authorization": "Bearer token"},
),
# Stdio 기반 MCP 서버 (subprocess로 실행)
MCPServerStdio(
"npx",
args=["@modelcontextprotocol/server-google"],
env={"GOOGLE_API_KEY": "..."},
),
],
)동작 방식
MCP 서버는 전화가 올 때마다 자동으로 시작되고, 통화 종료 시 정리됩니다:
- 전화 수신 → MCP 서버 프로세스 시작 (Stdio) 또는 HTTP 연결
- MCP 프로토콜로
tools/list호출 → 사용 가능한 도구 목록 수집 @agent.tool로 등록한 도구와 함께 AI에 자동 등록- AI가 MCP 도구를 호출하면 → MCP 프로토콜로
tools/call전달 - 통화 종료 → MCP 서버 연결 종료 및 도구 정리
주의사항
@agent.tool과 MCP 도구의 이름이 충돌하면AgentError가 발생합니다- MCP 서버 연결이 실패하면 해당 통화의 AI 처리가 시작되지 않습니다