커스텀 에이전트를 위한 MCP 연결

MCP(Model Context Protocol) 연결을 사용하면 사용자 지정 에이전트가 외부 앱에 안전하게 연결할 수 있습니다. MCP 연결을 통해 에이전트는 Linear, Ramp, Figma 등과 같은 앱과의 사전 구성된 연결을 사용하여 정보를 읽고 작업 또는 액션 아이템을 수행하거나, 사용자 지정 MCP 연결을 설정하여 모든 앱에 연결할 수 있습니다.

참고: MCP 연결은 비즈니스 및 엔터프라이즈 요금제에서만 지원됩니다.

MCP 연결을 사용하면 사용자 지정 에이전트가 Model Context Protocol을 통해 외부 도구 및 서비스와 상호 작용할 수 있습니다. MCP 도구는 주기 실행, Notion 또는 Slack 이벤트를 기반으로 트리거된 실행, 채팅 또는 @멘션에서 시작된 수동 실행을 포함한 모든 트리거 유형에서 작동합니다.

주요 기능:

• 사전 구성된 서버: 추가 구성 없이 인기 앱에 빠르게 연결할 수 있습니다.

• 사용자 지정 서버: 공개적으로 사용 가능한 URL을 사용하여 호스팅 MCP 서버를 지원하는 모든 도구에 연결합니다.

• 사용자 지정: 각 연결에 대한 도구를 토글을 켜거나 끌 수 있으며, 실행 전에 확인을 요구할지, 자동으로 실행할지, 또는 서버의 모든 도구를 영구적으로 허용할지 선택할 수 있습니다.

각 MCP 연결은 단일 사용자 지정 에이전트 전용이며 인증한 사람의 인증서를 사용합니다. 연결은 동일한 서비스에 연결되더라도 에이전트 간에 공유되지 않습니다.

이는 다음을 의미합니다.

• 에이전트 A에 Figma 연결을 설정한 경우, 에이전트 B에는 별도의 Figma 연결이 필요합니다.

• 구성하는 에이전트마다 각 MCP 서버에 로그인해야 합니다.

• 한 에이전트에서 연결을 취소해도 다른 에이전트에는 영향을 미치지 않습니다.

추가 구성 없이 다음 앱에 연결할 수 있습니다.

• Amplitude

• Attio

• Box

• ClickHouse

• Figma

• GitHub

• HubSpot

• Intercom

• Linear

• Mercury

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. 커스텀 에이전트의 설정을 여세요.

2. 도구 및 사용 권한으로 이동하세요.

3. 연결 추가 → 추가를 클릭하세요.

4. 사전 구성된 서버를 선택합니다.

5. 인증 안내 메시지에 따라 계정을 연결합니다.

6. 에이전트가 사용할 서버의 도구를 선택하세요. 이는 선택한 서버에 따라 달라집니다.

7. 연결을 클릭하세요.

사전 구성된 목록에 없는 MCP 서버에 연결하려면 워크스페이스 관리자가 먼저 이 옵션을 켜야 합니다. 사용자 지정 MCP 서버를 허용하는 설정과 멤버가 모든 연결을 설치할 수 있는지 또는 관리자가 승인한 연결만 설치할 수 있는지 결정하는 설정, 이렇게 두 가지 별도의 설정이 있습니다.

사용자 지정 MCP 서버를 허용하려면:

1. 워크스페이스 관리자로서 설정 → 연결으로 이동하세요.

2. 관리 탭에서 사용자 지정 MCP 서버 활성화를 켜세요.

멤버가 모든 연결을 설치할 수 있는지 또는 관리자가 승인한 연결만 설치할 수 있는지 선택하려면:

1. 워크스페이스 관리자로서 설정 → 연결으로 이동하세요.

2. 관리 탭에서 권한 섹션을 찾으세요.

3. 멤버가 설치할 수 있는 연결 제한 옆에서 하나를 선택하세요:

   • 승인됨 및 권장: Notion에서 권장하는 모든 연결을 자동으로 승인합니다.

   • 승인됨만: 멤버가 설치할 수 있는 각 연결을 수동으로 선택합니다.

4. 승인됨 연결을 선택하여 멤버가 설치할 수 있는 연결을 검토하세요.

5. 승인됨 연결 추가를 선택한 다음 허용할 연결을 선택하세요:

   • 연결: 이름 또는 ID로 연결을 검색하여 승인됨 목록에 추가하세요.

   • 사용자 지정 MCP 서버: 허용하려는 특정 사용자 지정 MCP 서버 URL을 추가합니다.

6. 저장을 클릭하세요.

이 설정이 완료되면 워크스페이스의 누구나 커스텀 에이전트를 설정할 때 승인됨 옵션에 연결할 수 있습니다. 사용자는 자신의 인증서로 인증하게 됩니다.

커스텀 에이전트에 사용자 지정 MCP를 추가하려면:

1. 커스텀 에이전트의 설정을 여세요.

2. 도구 및 사용 권한으로 이동하세요.

3. 연결 추가 → 사용자 지정 MCP 서버를 클릭하세요.

4. 연결하려는 도구 또는 제공업체(예: 사내 내부 도구 팀)에서 MCP 서버의 URL을 입력해야 합니다.

5. 연결에 사용할 표시 이름을 입력하세요(선택 항목).

6. 필수 인증 상세정보를 추가합니다.

7. 연결을 클릭하세요.

사용자 지정 MCP 서버는 다음 로그인 방법 중 하나 또는 둘 다를 지원할 수 있습니다:

• OAuth

• 헤더 기반 인증

  (예: API 키 또는 Bearer 토큰)

일부 OAuth 서버는 동적 클라이언트 등록(DCR)을 지원하지 않습니다. 즉, OAuth 로그인이 작동하려면 Notion이 타사 서비스에 클라이언트 애플리케이션을 미리 등록해야 합니다. 사용하려는 서버가 DCR을 지원하지 않는 경우, 해당 설명서를 확인하여 API 키나 베어러 토큰을 대신 사용할 수 있는지 확인하세요. 두 옵션 모두 사용할 수 없는 경우, 해당 MCP 서버는 커스텀 에이전트와 함께 사용할 수 없습니다.

에이전트의 설정 내 도구 및 사용 권한에서 커스텀 에이전트가 MCP 연결을 사용하는 방식을 결정할 수 있습니다. MCP 연결 항목을 확장하여 사용 가능한 도구를 확인하고 실행 방식을 결정하세요. 도구 옆의 토글을 사용하여 도구를 활성화하거나 비활성화할 수 있습니다.

읽기 및 쓰기 도구

• 읽기 도구(예: 검색, 가져오기, 리스트, 보기)를 사용하면 커스텀 에이전트가 외부 시스템을 변경하지 않고도 정보를 검색하거나 볼 수 있습니다.

• 쓰기 도구(예: 생성, 업데이트, 삭제, 전송, 게시물)은 외부 시스템의 데이터를 변경합니다. 기본적으로 이러한 도구는 에이전트가 작업을 실행하기 전에 확인이 필요합니다.

자동 실행 또는 항상 묻기

• 실행 자동화는 사용자의 확인 없이 도구를 실행할 수 있도록 합니다. 이 설정은 데이터를 수정하지 않는 읽기 도구(검색, 가져오기, 리스트 보기, 보기)에 가장 적합합니다.

• 항상 묻기는 작업이 실행되기 전에 사용자가 승인하거나 취소하도록 요구합니다. 이는 의도하지 않은 변경을 방지하기 위해 쓰기 도구(생성, 업데이트, 삭제, 전송)의 기본 설정입니다.

• 항상 허용은 서버의 모든 도구를 영구적으로 승인하고 향후 확인 메시지를 표시하지 않습니다.

MCP 연결 제거 방법

1. 에이전트의 설정을 엽니다.

2. 도구 및 사용 권한으로 이동합니다.

3. MCP 연결을 찾아 연결 해제를 클릭하세요.

4. 연결 해제를 클릭하여 확인하세요.

5. 변경 후에는 항상 에이전트를 테스트하세요. 다시 인증하면 언제든지 연결할 수 있습니다.

참고: 연결을 제거하면 에이전트가 해당 서비스에 더 이상 사용 권한을 가질 수 없으며 해당 서버에 의존하는 예약된 실행이 실패할 수 있습니다. 연결을 해제하는 즉시 에이전트의 워크플로가 중단될 수 있습니다. 다시 인증하면 언제든지 연결할 수 있습니다.

MCP 연결은 커스텀 에이전트에 설정된 사용자 권한 수준을 따릅니다. 각 권한 수준에서 MCP에 연결된 도구로 수행할 수 있는 작업은 다음과 같습니다.

모두 허용 및 편집 허용 권한이 있는 사용자는 다음을 수행할 수 있습니다.

• 커스텀 에이전트에 새 MCP 연결을 추가할 수 있습니다.

• 에이전트 외부에서 도구에 대한 사용 권한이 없더라도 에이전트와 채팅하고 연결된 모든 도구를 사용할 수 있습니다.

• 에이전트의 활동 로그 및 MCP 도구 사용 내역을 볼 수 있습니다.

• 기존 MCP 연결을 제거할 수 있습니다.

• MCP 서버 인증서를 다시 연결하거나 업데이트할 수 있습니다.

또한 사용자가 설정한 MCP 연결의 경우, 모두 허용 및 편집 허용 권한이 있는 사용자는 다음을 수행할 수 있습니다.

• 활성화하거나 비활성화할 도구를 구성하고 도구 실행 설정 변경(자동 실행 vs. 항상 묻기)

참고: MCP 연결이 설정되면, 다른 사용자가 커스텀 에이전트에 대한 모두 허용 또는 편집 허용 사용 권한을 가지고 있더라도 MCP 연결을 인증한 사람만 도구 설정을 구성하고 업데이트할 수 있습니다. 에이전트는 외부 서비스에 접근할 때 해당 사용자의 인증서와 권한을 사용합니다.

커스텀 에이전트에 대한 읽기 허용 및 상호 작용 권한이 있는 사용자는 다음을 수행할 수 있습니다.

• 커스텀 에이전트 외부에서 도구에 대한 사용 권한이 없더라도 커스텀 에이전트와 채팅하고 연결된 모든 도구를 사용할 수 있습니다.

• 에이전트를 통해 읽기 및 쓰기 작업을 모두 트리거할 수 있습니다.

• 확인이 필요한 경우 쓰기 작업을 승인하거나 취소할 수 있습니다.

• 연결된 MCP 서버 보기(커스텀 에이전트 설정에서)

읽기 및 상호 작용 허용 권한을 가진 사용자는 다음을 수행할 수 없습니다.

• MCP 연결 추가 또는 제거

• 활성화된 도구 변경

• 도구 실행 설정 수정

• 에이전트의 전체 활동 로그 보기

참고: 쓰기 작업(항목 생성 또는 업데이트 등)은 의도하지 않은 변경을 방지하기 위해 기본적으로 확인이 필요합니다. 사용자는 에이전트가 실행되기 전에 수행할 작업을 정확하게 보여주는 명령어를 보게 됩니다.

연결 후에도 도구가 표시되지 않는 경우:

• 에이전트 설정 페이지를 새로 고칩니다.

• MCP 서버가 성공적으로 인증되었는지 확인하세요(녹색 체크 표시 또는 '연결됨' 상태가 표시되는지 확인).

• 서버가 온라인 상태이고 도구 메타데이터를 반환하는지 확인합니다.

• 서버를 다시 연결하거나 연결을 해제하고 다시 추가해 보세요.

MCP 오류로 인해 커스텀 에이전트 실행이 실패한 경우:

• 활동 탭에서 특정 오류 메시지를 확인합니다.

• 연결이 여전히 유효한지 확인하세요(토큰이 만료되었을 수 있음).

• 에이전트 설정에서 연결이 여전히 활성화되어 있는지 확인하세요.

• MCP 서버를 다시 연결하여 인증서를 새로 고쳐 보세요.

• 사용하려는 서버 또는 도구 이름을 멘션하도록 커스텀 에이전트의 에이전트 지침을 업데이트하세요. 예: “Linear MCP를 사용하여 이 모의 데이터에 대한 메타데이터를 검색하세요.”