MCP (Model Context Protocol) 도구

MCP 도구를 사용하면 에이전트가 Zapier, Composio와 같이 MCP를 지원하는 다양한 외부 서비스 및 플랫폼에 연결할 수 있습니다. 이를 통해 에이전트는 이미 구축된 수많은 통합 기능을 활용하여, 대화 중에 직접 이메일 전송, 캘린더 일정 생성, CRM 기록 업데이트 등과 같은 복잡한 작업을 수행할 수 있게 됩니다.

MCP 도구 설정 이해하기

MCP 도구를 효과적으로 설정하고 관리하기 위해서는 다음 주요 구성 필드들을 이해하는 것이 중요합니다. 각 필드는 MCP 도구가 어떻게 MCP 공급자 서버와 통신하고, 에이전트가 이를 통해 어떤 작업을 수행할 수 있는지를 정의합니다.

주요 구성 필드:

  • 이름: MCP 도구 설정을 식별하는 고유한 이름입니다. 시스템 내에서 특정 MCP 연결을 구분하는 데 사용됩니다. (예: zapier_create_lead, composio_github_search_issue)
  • 설명: 해당 MCP 도구 설정이 어떤 작업을 수행하는지에 대한 설명입니다. 에이전트가 이 도구를 언제, 왜 사용해야 하는지 판단하는 데 도움을 줍니다. (예: “Zapier를 통해 Salesforce에 새 리드를 생성합니다.” 또는 “Composio를 사용하여 GitHub 리포지토리에서 이슈를 검색합니다.”)
  • 엔드포인트: 이 필드의 값은 사용하는 MCP 공급자에 따라 달라집니다.
    • Zapier의 Zap URL이나 Composio의 Action URL처럼, MCP 서비스에서 제공하는 특정 작업 URL일 수 있습니다.
    • 또는 사용자의 시스템이 특정 MCP 작업을 위한 연결 정보를 찾는 데 사용하는 내부 식별자일 수도 있습니다.
    • 정확한 값은 사용 중인 MCP 공급자(Zapier, Composio 등)의 공식 문서를 참조하여 설정해야 합니다. 일반적으로 MCP 공급자의 플랫폼에서 실제 연결 및 작업을 구성한 후, 해당 설정을 가리키는 값으로 사용됩니다.
  • 타임아웃: 에이전트가 MCP 서비스로부터 응답을 기다리는 최대 시간(초)입니다.

MCP 작동 방식

MCP는 에이전트가 자신의 의도와 필요한 데이터를 외부 서비스(MCP 공급자)에 전달하는 표준화된 통신 규약 역할을 합니다. 이 외부 서비스는 전달받은 내용을 바탕으로 실제 작업을 실행합니다. 요청/응답 형식이나 인증과 같은 구체적인 통신 절차는 대부분 MCP 공급자 측에서 처리합니다.

  1. 필요성 인지: 에이전트는 대화의 흐름을 파악하여 MCP 도구를 통해 처리할 수 있는 작업이 필요하다고 판단합니다. (예: “내 캘린더에 이 내용을 미리 알림으로 추가해 줄래?”)
  2. 도구 호출: 에이전트는 설정된 MCP 도구를 호출하며, 대화에서 수집한 관련 정보(예: 미리 알림 내용, 날짜, 시간 등)를 매개변수로 전달합니다.
  3. MCP 공급자 작업 수행: 사용자의 시스템(또는 중간 시스템)은 엔드포인트 정보 등을 활용하여 설정된 MCP 공급자(예: Zapier)와 통신합니다. MCP 공급자는 이 요청을 받아 사전에 정의된 워크플로우(예: Google Calendar에 일정 생성)를 실행합니다.
  4. 결과 반환: 작업 실행 후 MCP 공급자는 성공 여부와 관련 결과 데이터를 응답으로 반환하며, 이 정보는 다시 에이전트에게 전달됩니다. 에이전트는 이 결과를 바탕으로 사용자에게 작업 완료 여부나 다음 단계를 안내합니다.

MCP 공급자 예시

  • Zapier: 수천 개의 다양한 앱과 서비스를 연결할 수 있는 자동화 플랫폼입니다. 일반적으로 Zapier에서 ‘Zap’이라는 자동화 워크플로우를 생성하고, 해당 Zap의 웹훅 URL이나 고유 식별자를 엔드포인트로 사용합니다.
  • Composio: 다양한 SaaS 도구와의 통합을 용이하게 해주는 플랫폼입니다. Composio 대시보드에서 원하는 도구와의 연동 작업을 설정하고, 제공되는 서버 URL 또는 식별자를 엔드포인트로 활용합니다.

모범 사례

  • 명확한 설명 작성: MCP 도구의 설명을 명확하고 구체적으로 작성하여 에이전트가 각 도구의 용도를 정확히 이해하고 적절한 상황에 사용하도록 유도해야 합니다.
  • 매개변수 처리 방식 이해: 사용하려는 MCP 공급자가 매개변수를 어떻게 처리하고 기대하는지 정확히 파악해야 합니다. 경우에 따라 MCP 공급자 플랫폼에서 매개변수 매핑을 별도로 설정해야 할 수도 있습니다.
  • 인증 관리: Google Calendar, Salesforce 등 최종 서비스와의 인증은 대부분 MCP 공급자(Zapier, Composio 등)의 플랫폼 내에서 안전하게 처리됩니다. 해당 플랫폼에서 인증 설정을 올바르게 완료했는지 확인하세요.
  • 응답 데이터 크기 관리: 일부 MCP 도구 호출(특히 데이터 조회 관련)은 매우 큰 데이터를 반환할 수 있습니다. 이는 에이전트 모델의 컨텍스트 제한을 초과하여 성능 저하나 오류를 유발할 수 있으므로, MCP 공급자 측에서 워크플로우를 설정할 때 반환되는 데이터를 필요한 정보 중심으로 필터링하거나 요약하도록 구성하는 것이 좋습니다.

MCP 도구 설정, 특히 엔드포인트 값 확인 및 통합에 필요한 자세한 절차는 사용하려는 특정 MCP 공급자의 공식 문서를 항상 참조하는 것이 중요합니다.

참고 자료