🐍07. MCP 연동과 외부도구 생태계

에이전트가 진짜 업무를 하려면 외부 도구와 연결되어야 합니다. PydanticAI는 MCP와 toolset 개념을 통해 “도구 확장”을 표준화된 방식으로 다룰 수 있게 합니다.

AI 활용 안내: 이 문서는 생성형 AI를 활용해 작성했으며, Pydantic AI 공식 문서를 1차 출처로 검토해 정리했습니다.

공식문서 흐름 점검 (개요 보완)

• 흐름: MCP 개념(클라이언트/서버) → Toolset 조합(필터/프리픽스/리네임) → 동적 Toolset 구성/승인 게이트 → Third-party 도구 연계.
• 이번 편에서 빠지면 안 되는 포인트:
  • MCP는 “툴 호출 표준”이고 Toolset은 “운영 묶음”이라는 차이를 분명히 한다.
  • 외부 도구 연결 시 승인/권한/실패 격리 기준을 개요에 넣는다.
  • LangChain 등 서드파티 연동은 호환성 검증 순서를 제시한다.
• 공식 문서 체크 링크:
  • https://ai.pydantic.dev/mcp/overview/index.md
  • https://ai.pydantic.dev/toolsets/index.md
  • https://ai.pydantic.dev/third-party-tools/index.md

MCP를 먼저 이해해야 하는 이유

MCP는 모델과 도구를 연결하는 공통 프로토콜입니다. 팀마다 도구가 달라도 연결 방식이 통일되면, 에이전트 유지보수가 쉬워집니다.

공식 문서:

• MCP Overview: https://ai.pydantic.dev/mcp/overview/
• Toolsets: https://ai.pydantic.dev/toolsets/

flowchart TD
  A[Agent] --> B[MCP Client]
  B --> C[MCP Server 1: 검색]
  B --> D[MCP Server 2: 문서]
  B --> E[MCP Server 3: 티켓]
  C --> F[통합 응답]
  D --> F
  E --> F

미니 사례 A: 팀마다 도구 연결 방식이 달라 파편화된 경우

A팀은 REST, B팀은 직접 SDK, C팀은 수동 파일 업로드를 써서 운영 복잡도가 높았습니다. MCP 기반으로 표준화하자 신규 도구 온보딩이 빨라졌습니다.

미니 사례 B: 외부 도구 장애가 전체 품질을 흔든 경우

한 도구가 느려지면 전체 응답이 느려졌습니다. toolset 단위로 타임아웃과 fallback 규칙을 분리해 영향 범위를 줄였습니다.

실무 적용 순서

1. 연결할 외부 도구 목록 우선순위화
2. MCP 기반 연결 가능/불가 분류
3. 도구별 SLA(응답시간/실패정책) 정의
4. 최소 1개 워크플로우를 표준 경로로 운영

성공 판정:

• 새 도구 추가 절차가 문서화됐다
• 도구 장애의 영향 범위를 제한한다
• 도구 연결 변경이 Agent 핵심 로직을 덜 건드린다

다음 글

• 🐍08. Graph로 복잡 플로우 설계
• 🐍06. 멀티에이전트·A2A 패턴
• 🐍 PydanticAI 허브