MCP
MCP(Model Context Protocol)는 Agent가 외부 도구와 비즈니스 서비스에 연결할 수 있게 합니다. 기능 센터에서 기존 서비스를 찾고, 사내 또는 개인 MCP를 연동하며, 인증을 완료한 후 작업에 필요한 대로 사용할 수 있습니다.
진입 경로: 기능 센터 → MCP.
이 페이지는 도구를 사용해야 하는 멤버와 MCP 연동 및 유지 관리를 담당하는 관리자를 위한 것입니다. 검색 키워드: MCP, 도구 서비스, 연결 템플릿, OAuth, 인증, 외부 클라이언트.
MCP 서비스 찾기 및 선택
MCP 페이지로 이동하여 이름으로 검색하고, 출처와 카테고리로 서비스를 필터링합니다. 최신, 호출 많은 순, 좋아요 많은 순으로 정렬할 수도 있습니다. 서비스 상세를 열어 소개, 포함된 도구, 설정을 확인하고 작업을 완료할 수 있는 서비스인지 먼저 확인합니다.
- 시스템 MCP: 플랫폼에 사전 설정된 서비스로, 설정은 읽기 전용이며 여기에서 편집하거나 삭제할 수 없습니다.
- 사내 MCP: 같은 회사 안에서 볼 수 있는 서비스로, 회사 리소스 관리 권한이 있는 관리자가 유지 관리합니다.
- 개인 MCP: 직접 생성하고 관리하는 서비스로, 개인 연동과 검증에 적합합니다.
도구 이름과 용도를 확인하려면 상세의 도구에서 도구 설명을 펼칩니다. 도구 범위는 서비스 설정과 권한 부여에 따라 달라질 수 있으므로 현재 반환된 도구 목록을 기준으로 합니다.
AE 내장 비즈니스 기능을 사용하려는 경우 먼저 CLI를 읽으십시오. 현재 Web 대화에서는 더 이상 시스템 MCP를 선택 가능한 도구 기능으로 제공하지 않습니다.
사내 또는 개인 MCP 연동
시작하기 전에 서비스 제공자가 제공한 연결 주소, 전송 방식, 인증 정보를 준비합니다. MCP 페이지로 이동하여 생성 진입점을 클릭한 다음 아래 단계에 따라 설정합니다.
- 생성 범위 선택. 일반 멤버는 개인 MCP를 생성할 수 있고, 회사 리소스 관리 권한이 있는 관리자는 사내 MCP를 생성할 수 있습니다. 회사 관리 권한에는 Agent 관리자와 시스템 관리자가 포함되며, 특정 워크스페이스의 관리 권한과는 다릅니다.
- 연동 방식 선택. 해당 템플릿이 있으면 Slack, Feishu OpenAPI, Lark OpenAPI 또는 DingTalk 템플릿을 사용하고 양식에 따라 정보를 채웁니다. 그 밖의 서비스는 사용자 정의 연동을 선택합니다. 일반 멤버도 템플릿을 사용하여 개인 MCP를 생성할 수 있습니다.
- 연결 정보 입력. 사용자 정의 연동은 SSE, HTTP, Streamable HTTP를 지원하며, 전송 방식은 서비스 제공자와 일치해야 합니다. 이름, 서비스 주소, 인증 정보를 입력한 후 저장합니다.
Feishu OpenAPI, Lark OpenAPI 템플릿은 플랫폼이 호스팅하는 연동 방식을 사용하며 앱 정보를 입력해야 합니다. 이는 일반 생성 양식에서 임의의 로컬 stdio 명령을 실행할 수 있다는 의미가 아닙니다.
Header, OAuth 또는 앱 시크릿을 항목별로 설정해야 하면 MCP 인증 및 설정 매뉴얼을 바로 읽으십시오.
인증 완료 및 도구 검증
저장에 성공했다고 해서 인증이 완료된 것은 아니며, 모든 도구를 호출할 수 있다는 의미도 아닙니다. 서비스를 저장한 후 해당 인증 방식에 따라 설정을 완료하고, 도구 목록과 실제 호출 결과를 확인합니다.
- 인증 없음: 서비스 자체가 자격 증명을 요구하지 않는 경우에만 사용하며, 이 경우에도 주소와 네트워크 연결을 확인해야 합니다.
- 수동 헤더: 서비스 요구 사항에 따라 요청 헤더를 입력합니다. Token, API Key 등 민감한 값은 암호화를 선택해야 하며, 이름이나 설명에 입력하지 마십시오.
- OAuth 2.0: 페이지 안내에 따라 서비스 제공자로 이동하여 권한 부여를 완료합니다. 권한 부여 페이지가 자동으로 열리지 않으면 인증 진입점을 사용하여 계속합니다. 돌아온 후 인증 상태를 확인합니다.
- 앱 시크릿: 해당 템플릿에 따라 앱 ID와 앱 시크릿을 입력하고, 서비스 제공자에서 필요한 앱 권한 설정을 완료합니다.
설정을 완료한 후 서비스 상세를 열어 도구 목록을 로드하고 이름과 용도를 확인한 다음, 대화에서 위험이 낮고 결과를 검증할 수 있는 호출을 한 번 실행합니다. 도구 목록이 로드된다는 것은 도구 목록을 가져왔다는 의미일 뿐이며, 실제 호출은 여전히 비즈니스 데이터 권한이나 권한 부여 범위의 제한을 받을 수 있습니다.
권한 부여를 추가하거나, 인증 서비스를 선택하거나, 인증 실패를 처리해야 하면 MCP 인증 및 설정 매뉴얼을 바로 읽으십시오.
Agent와 워크스페이스에서 MCP 사용
MCP를 연동한 후에도 사용 목적에 따라 기능을 설정해야 합니다. Agent 설정, 공간 공용 기능, 대화에서의 선택은 역할이 서로 다르며, MCP를 하나 생성했다고 해서 모든 설정이 자동으로 완료되지는 않습니다.
- 특정 Agent가 도구를 사용하도록 하기: 해당 Agent의 기능 설정에서 사용 가능한 MCP를 연결합니다. 설정 방법은 Agent를 참고하십시오.
- 워크스페이스의 공용 기능 설정: 권한이 있는 공간 관리자가 공간 기능 설정에서 MCP를 선택합니다. 공유 공간에서는 개인 MCP를 사용할 수 없습니다. 범위와 작업은 새 공간 생성하기를 참고하십시오.
- 특정 작업에서 도구 사용: 대상 공간과 대화로 이동하여 현재 Agent, 사용 가능한 기능, 인증 상태를 확인한 후 작업을 요청합니다. 자세한 작업은 대화를 참고하십시오.
회사가 공유하는 것은 서비스 설정이며, 각 사용자의 OAuth 권한 부여까지 공유하는 것은 아닙니다. 사용자는 여전히 자신의 인증을 완료하고 관련 비즈니스 권한을 갖추어야 합니다. 공간에 참여해도 사내 MCP의 설정 관리 권한을 자동으로 얻지는 않습니다.
대화에서 시스템 MCP를 찾을 수 없으면 CLI의 해당 비즈니스 기능 진입점을 사용하십시오. 시스템 MCP를 선택하거나 활성화하려고 반복해서 시도할 필요가 없습니다.
외부 클라이언트 연결
MCP 상세를 열어 현재 설정을 확인합니다. 페이지에 클라이언트에 추가 진입점이 있으면 설치 안내에 따라 클라이언트를 선택하고 연동을 완료할 수 있습니다. 수동 설정을 사용하는 경우 클라이언트가 해당 전송 방식을 지원하고 서비스 주소에 접근할 수 있는지 먼저 확인해야 합니다.
모든 MCP를 로컬로 내보낼 수 있는 것은 아닙니다. 일반 원격 서비스와 플랫폼 호스팅 연결은 적용 조건이 다릅니다. 사내 또는 개인 MCP가 호스팅 OAuth, 앱 시크릿 또는 호스팅 stdio를 사용하는 경우 일반 원격 설정으로 바로 내보낼 수 없습니다. 상세에 표시된 호스팅 설정도 로컬에 복사하면 바로 실행할 수 있다는 의미가 아닙니다.
설치 과정에서 설정에 정적 키가 포함되어 있다는 안내가 표시되면, 대상 클라이언트를 신뢰할 수 있는지 먼저 확인한 후 내보낼지 결정합니다. Token, 키 또는 자격 증명이 포함된 설정을 공개 문서, 그룹 채팅, 코드 저장소에 붙여 넣지 마십시오.
mcp-token은 사용자의 Agentic Engine 신원에 대응하므로 모든 프로젝트 권한과 역할이 그대로 적용된다는 점에 유의하십시오. 사용자는 이미 접근 권한이 있는 프로젝트의 데이터만 볼 수 있으며, 조회 유형의 tool에는 데이터 권한이 계속 적용됩니다.
연동 후 대상 클라이언트에서 도구 목록을 확인하고 호출을 검증합니다. 인증이나 설정 문제가 발생하면 MCP 인증 및 설정 매뉴얼을 참고하십시오.
관리, 권한 및 자주 묻는 질문
활성화 또는 비활성화. 사내 MCP의 스위치는 현재 사용자의 사용 상태만 조정하며, 회사 전체의 서비스를 비활성화하는 것이 아닙니다. 개인 MCP는 생성자가 관리합니다. 시스템 MCP에는 이 스위치가 없습니다.
설정 편집. 개인 MCP는 생성자가 편집하고, 사내 MCP는 회사 리소스 관리 권한이 있는 관리자가 편집합니다. OAuth 서비스 주소나 인증 설정을 변경하면 기존 권한 부여가 무효화될 수 있으며, 사내 MCP를 변경하면 다른 사용자에게 재인증을 요구할 수도 있습니다. 표시 정보만 수정하는 경우에는 이로 인해 권한 부여가 삭제되지 않습니다.
재인증 및 인증 해제. 미인증 또는 재인증 필요 안내가 표시되면 페이지 안내에 따라 권한 부여를 완료합니다. 인증 해제는 플랫폼에 저장된 현재 사용자의 해당 서비스 권한 부여를 삭제하고 연결을 비활성화하지만, 회사에서 공유한 MCP 설정은 삭제하지 않습니다. 다시 사용하려면 재인증해야 합니다.
서비스 삭제. 본인에게 관리 권한이 있는 개인 또는 사내 MCP만 삭제할 수 있으며, 시스템 MCP는 삭제할 수 없습니다. 삭제하면 해당 서비스와 관련 자격 증명을 더 이상 사용할 수 없으므로, 작업 전에 이 서비스에 의존하는 Agent, 공간 또는 대화가 있는지 확인해야 합니다.
- 서비스를 찾을 수 없음: 출처와 검색 조건을 확인하고, 본인이 생성한 개인 MCP인지 또는 자사의 MCP인지 확인합니다. 공유 공간에서는 개인 기능을 사용할 수 없습니다.
- 연결 실패: 서비스 주소, 전송 방식, 네트워크 도달 가능성, Header 설정을 확인하고, 저장됨 표시만으로 연결 가능 여부를 판단하지 마십시오.
- 도구 목록이 비어 있거나 호출이 거부됨: 먼저 인증 상태를 확인한 다음 권한 부여 범위, 서버 측 도구 설정, 비즈니스 데이터 권한을 확인합니다. 일시적인 네트워크 문제나 새로고침 실패는 먼저 재시도하면 되며, 무조건 다시 권한을 부여할 필요는 없습니다.
- 편집 진입점이 없음: 먼저 리소스 출처와 본인의 회사 리소스 관리 권한을 확인합니다. 서비스를 사용할 수 있다고 해서 설정을 수정할 수 있는 것은 아닙니다.
인증과 설정의 자세한 문제 해결은 MCP 인증 및 설정 매뉴얼을 참고하십시오. 도구는 사용할 수 있지만 작업에서 여전히 사용할 수 없으면 대화의 기능 선택 설명을 이어서 확인하십시오.