MCP Actions

MCP(Model Context Protocol)는 AI가 다른 서비스의 도구를 직접 사용하게 하는 공개 표준입니다. 엔드포인트와 매개변수를 직접 설명하는 대신 MCP 서버가 도구를 게시하고 AI 에이전트가 발견하여 사용합니다.

대부분 한 번의 클릭으로 연결할 수 있습니다. Actions 및 MCPs에서 + Action 추가를 클릭하고 MCP를 선택하세요.

Cloudflare 문서 또는 Microsoft Learn 엔드포인트의 예시 MCP 연결을 검사하세요. 초기화와 도구 목록 요청만 하며 로그인이나 도구 실행은 하지 않습니다.

선택적으로 사용할 수 있는 설정 도구

• MCP 메모리 매핑 미리보기. 도구 호출이나 대화 메모리 변경 없이 입력한 메모리 규칙을 예시 MCP 도구 결과에 적용합니다.

• MCP 도구 목록 비교하기. 두 도구 목록과 활성화 설정을 비교하여 정의 변경과 검토 지점을 확인합니다. 서버에 연결하거나 호환성을 입증하지는 않습니다.

• MCP 연결 방향 확인하기. 공개 엔드포인트와 선택한 목적을 바탕으로 설정 초안을 만듭니다. 인증 정보를 받거나 서버에 연결하거나 계정을 변경하지 않습니다.

카탈로그에서 연결

MCP 화면은 잘 알려진 서비스를 검색할 수 있는 카탈로그로 열립니다. 인기, 고객 지원, CRM 및 영업, 일정 관리, 이커머스, 결제 및 청구, 마케팅 및 이메일, 커뮤니케이션, 생산성, 데이터 및 분석, 검색 및 웹, 여행 및 예약, 디자인, 개발 및 인프라로 분류됩니다.

1. 목록을 둘러보거나 검색창으로 서비스를 찾으세요.
2. 타일을 클릭하세요. Quickchat이 서버를 검사하고 제공하는 도구를 찾습니다.
3. 로그인이 필요하면 인증 필요 패널이 표시됩니다. <서비스> 연결을 클릭하고 팝업에서 접근을 승인하면 연결됨으로 바뀝니다.
4. Action이 생성되어 활성화되고 도구가 나열됩니다. 다음 메시지부터 에이전트가 사용할 수 있습니다.

참고

승인을 시작한 뒤 Actions 시트나 인증 팝업을 닫아도 Action과 대기 중인 승인은 유지됩니다. Action을 다시 열어 인증 다시 열기로 계속하거나 취소로 중단하세요. 시트를 닫은 뒤 제공업체에서 승인이 완료되면 Quickchat은 백그라운드에서 연결을 완료하고 요금제에 여유가 있을 때 Action을 활성화합니다.

팁

인증 창을 열려면 브라우저에서 Quickchat 대시보드의 팝업을 허용해야 합니다. 차단되면 팝업을 허용하고 다시 시도하라는 메시지가 표시됩니다.

카탈로그에 없는 서버 연결

카탈로그 아래 URL 직접 입력을 클릭한 뒤 다음을 따르세요.

1. MCP 서버 URL을 붙여 넣으세요(https://로 시작해야 합니다).
2. 로그인 대신 고정 토큰으로 인증하는 서버라면 연결 헤더(선택 사항)를 열고 Authorization: Bearer <your-token>처럼 필요한 헤더를 추가하세요.
3. 연결을 클릭하세요.

타일 화면으로 돌아가려면 카탈로그 둘러보기를 사용하세요. 필요한 서비스가 없으면 원하는 연동이 없나요? 제안해 주세요를 클릭하여 팀에 보낼 이메일 초안을 여세요.

AI가 사용할 도구 선택

연결하면 서버가 제공하는 모든 도구가 각각의 스위치와 함께 나열됩니다. AI가 호출하지 않아야 할 것은 끄세요. 예를 들어 예약 서버의 읽기 전용 조회는 켜고 취소 도구는 끌 수 있습니다.

기본 도구 활성화는 나중에 서버가 새 도구를 추가했을 때를 결정합니다. 켜면 즉시 사용 가능하고, 끄면 직접 하나씩 활성화해야 합니다.

일부 항목에는 Quickchat이 조정함 표시가 있습니다. Quickchat이 전체 흐름을 테스트하고 필요한 도구 선택, 메모리 규칙, 각 처리 중 메시지를 제공합니다. 권장 설정 사용을 선택하면 권장 설정을 적용할까요? 대화상자에서 켜고 끌 도구와 적용할 메모리 규칙을 확인할 수 있습니다. 직접 수정한 규칙을 덮어쓰게 되면 경고합니다. Action을 저장하기 전에는 저장되지 않으며 이후에도 모든 도구를 조정할 수 있습니다.

팁

MCP Action 이름과 MCP Action 설명은 팀을 위한 라벨로 목록에서 식별하는 데 쓰이며 AI는 읽지 않습니다. AI를 안내하는 것은 서버가 게시한 도구 설명과 에이전트의 메인 프롬프트입니다. “모든 프로젝트 질문에는 Linear 도구를 사용”처럼 사용할 상황과 “항상 acme-eng 워크스페이스를 검색”처럼 추측하면 안 되는 값을 명시하세요. 같은 서버를 두 번 연결하면 제공업체 이름 대신 “Notion 도움말”, “Notion 지원 요청”처럼 용도로 이름을 정하세요.

Calendly 예약 시간

Action 하나가 Calendly의 https://mcp.calendly.com 서버에 연결되고 아래 두 도구를 모두 켜면 Quickchat은 현지 시간 입력을 제공합니다. 이름은 그대로이며 별도 변환 도구는 추가되지 않습니다. 둘 중 하나만 켜면 Calendly의 원래 입력을 유지합니다.

• 예약 가능 시간: event_types-list_event_type_available_times는 local_start_time, local_end_time, Europe/London 같은 IANA timezone을 받습니다. 현지 날짜와 시간을 YYYY-MM-DDTHH:MM:SS 형식으로 보내세요. Quickchat이 23시간 또는 25시간인 시계 변경일을 포함하여 해당 날짜의 시간대 규칙에 따라 UTC로 변환합니다.
• 예약: meetings-create_invitee는 post_invitee_request 안에 선택한 옵션의 local_start_time과 booking_timezone을 받습니다. 기존 invitee.timezone은 고객의 시간대로 유지되며 예약 장소의 시간대와 다를 수 있습니다. 예를 들어 America/New_York의 초대자가 Europe/London으로 표현된 시간을 예약할 수 있습니다.

예약 가능 옵션이 반환한 현지 시간과 시간대를 그대로 복사하세요. UTC 오프셋이 있으면 유지해야 시계를 되돌릴 때 반복되는 시간을 구분할 수 있습니다. 유효하지 않거나 존재하지 않는 시간, 오프셋 없는 모호한 시간, 명명된 시간대와 일치하지 않는 오프셋은 거부됩니다.

시간을 제안했다고 예약되는 것은 아닙니다. 생성 전에 Quickchat이 현재 가능 여부를 다시 확인하고 일치하는 제공업체 타임스탬프를 그대로 Calendly에 전달합니다. 더 이상 가능하지 않으면 예약을 시도하지 않습니다. 성공 결과에는 확인용 현지 표시 시간이 포함되며 $.resource.event처럼 메모리에 저장에서 쓰는 제공업체 필드도 유지됩니다.

메인 프롬프트에 고객 승인 요건을 유지하고 제공업체의 성공 결과 후에만 예약 완료를 안내하세요. 브라우저나 메시징 채널과 관계없이 대화에서 예약 시간대를 명확히 정하세요. 불분명하면 가능 시간 확인이나 예약 전에 고객에게 물어보세요.

MCP 도구 결과를 메모리에 저장

나중에 필요한 결과 값이 있다면 도구를 펼쳐 메모리에 저장을 사용하세요. 값의 JSONPath와 식별할 메모리 키를 추가합니다. 도구 하나에서 최대 10개 값을 저장할 수 있습니다.

메모리 키는 에이전트의 API Actions와 공유됩니다. API Action이 같은 키를 사용 중이면 저장 시 메모리 키 필드에 충돌이 표시되므로 다른 키를 선택하세요.

저장된 값은 AI가 후속 대화에서 읽을 수 있는 대화 데이터가 됩니다. 예를 들어 예약 도구가 이벤트 URI를 저장하면 취소 도구가 정확한 회의를 알 수 있습니다. MCP 도구의 인수는 AI가 직접 제공하므로 API Actions의 {{metadata_<key>}} 자리표시자를 사용하지 않습니다.

모두 활성화, 모두 비활성화는 메모리 규칙을 유지합니다. 다시 연결도 서버 도구 목록을 새로고침하면서 선택한 도구와 메모리 규칙을 유지합니다.

방문자에게 표시되는 내용

도구 실행 중 Widget에 AI의 작업을 설명하는 짧은 상태 문구가 표시됩니다. 도구 패널의 처리 중 메시지를 비워두면 도구 이름에서 문구를 만듭니다(search_flights는 “항공편 검색 중…”). “도움말 검색 중”처럼 직접 적을 수도 있습니다. 조정된 서버의 권장 도구에는 미리 채워져 있습니다. 단순한 입력 표시 대신 대기 중 의미 있는 정보를 제공합니다.

다시 연결 및 연결 해제

• 다시 연결: 승인을 다시 진행합니다. 연결 만료, 다른 계정 승인, 서버 도구 목록 변경 후 새 도구 반영에 사용하세요.
• 연결 해제: 저장한 승인을 취소하고 Action을 오프라인으로 전환합니다. Action은 목록에 남아 나중에 다시 설정하지 않고 연결할 수 있습니다.

연결된 Action의 MCP 서버 URL을 바꾸면 한 서버의 인증 정보를 다른 서버에 재사용하지 않도록 승인을 지우고 Action을 끕니다. 다시 승인하면 사용할 수 있습니다.

문제 해결

표시 내용	의미
인증이 완료되지 않았습니다	다시 시도를 클릭하세요. 접근을 거부했다면 다음에는 승인하세요. 또 실패하면 표시된 오류 코드와 함께 지원팀에 문의하세요.
연결되었지만 도구를 불러오지 못했습니다	승인은 성공했지만 도구 목록을 불러오지 못했습니다. 다시 연결을 클릭하세요.
이 서버에서 도구를 찾지 못했습니다. 다시 연결해 보세요.	서버가 승인했지만 도구를 게시하지 않았습니다. 승인한 계정에 예상 데이터 접근 권한이 있는지 확인하세요.
https:// 로 시작하는 유효한 URL을 입력하세요	URL을 읽을 수 없습니다. 전체 https:// 주소를 사용하세요. Quickchat은 인증 정보가 암호화 없이 전송되지 않도록 항상 https로 연결합니다.
Action이 저절로 꺼짐	제공업체의 승인이 만료되거나 취소되었습니다. Action을 열고 다시 연결을 클릭하세요.

참고

MCP Actions도 API Actions와 동일하게 요금제의 맞춤 Actions 한도에 포함됩니다.