커스텀 커넥터 (MCP)

그리디는 Model Context Protocol(MCP) 표준을 지원합니다. Notion, Sentry처럼 MCP 서버를 제공하는 외부 서비스나 직접 만든 MCP 서버를 추가하면, 에이전트가 그 서버의 도구를 호출해 데이터를 가져오거나 작업을 수행할 수 있습니다.

커스텀 커넥터는 유저 메뉴 → 설정 → 연동 → 커스텀 탭에서 관리합니다.

커넥터 추가하기

설정 열기

설정 → 연동 → 커스텀 탭에서 커스텀 커넥터 추가 버튼을 클릭합니다.

서버 URL 입력

MCP 서버의 URL을 입력합니다. 예시:

• Notion: https://mcp.notion.com/mcp
• Sentry: https://mcp.sentry.dev/mcp
• 직접 운영하는 서버: https://mcp.example.com/mcp

이름은 URL에서 자동으로 채워지지만, 직접 수정할 수 있습니다.

인증 처리

OAuth가 필요한 서버(Notion, Sentry 등)는 저장 버튼을 누르면 자동으로 인증 팝업이 열립니다. 외부 서비스에 로그인하고 권한을 허용하면 자동으로 연결이 완료됩니다.

API 토큰을 요구하는 서버(GitHub Copilot MCP 등)는 고급 설정을 펼치고 액세스 토큰을 입력하세요. Authorization: Bearer <토큰> 헤더로 전송됩니다.

인증이 필요 없는 서버는 URL만 입력하고 저장하면 됩니다.

채팅에서 도구 사용하기

추가한 커넥터의 도구를 사용하려면 채팅에서 에이전트에게 활성화를 요청하세요. 도구가 너무 많으면 토큰 비용이 늘어나기 때문에, 그리디는 필요한 커넥터만 골라서 활성화합니다.

Notion 커넥터 활성화해서 어제 회의록 검색해줘.

활성화된 커넥터의 도구는 채팅 UI에서 서버 favicon과 사람이 읽기 좋은 이름(예: Search Pages)으로 표시됩니다.

보안 — 추가 전에 꼭 확인하세요

커스텀 커넥터는 강력한 만큼 신중하게 추가해야 합니다. 추가하는 서버는 다음과 같은 권한을 갖게 됩니다.

개인 계정에 연결됩니다

OAuth 토큰과 API 키는 본인 계정에 묶여 저장됩니다. 예를 들어 Notion 커넥터를 추가하면 본인이 접근 가능한 모든 Notion 워크스페이스/페이지에 그 서버가 본인 권한으로 접근할 수 있습니다. 같은 그리디 워크스페이스의 다른 사용자가 본인의 토큰을 쓰지는 못하지만, 추가한 본인은 충분한 권한을 위임한 것이라는 점을 기억하세요.

에이전트가 자동으로 호출합니다

활성화된 커넥터의 도구는 에이전트가 자율적으로 호출합니다. 호출 시마다 일일이 확인을 받지 않으며, 도구가 반환한 응답은 에이전트의 다음 판단에 그대로 반영됩니다.

데이터가 외부로 나갈 수 있습니다

에이전트가 도구를 호출할 때, 호출에 필요한 인자(예: 검색 쿼리, 워크북 셀 값)가 그 외부 서버로 전송됩니다. 민감한 데이터를 다루는 워크북에서는 어떤 커넥터를 활성화할지 신중히 선택하세요.

그리디가 자동으로 차단하는 것

• 사설망/메타데이터 주소 차단: localhost, 127.0.0.1, 192.168.x, 10.x, 169.254.169.254(AWS 메타데이터) 같은 내부 주소는 등록할 수 없습니다.
• 토큰 암호화 저장: 모든 토큰은 AES-256-GCM으로 암호화돼 데이터베이스에 저장되며, 호출 시점에만 메모리에서 복호화됩니다.
• HTTPS 권장: http://도 기술적으로 허용하지만 평문 전송이므로 운영 환경에서는 반드시 https://를 사용하세요.

커넥터 수정·삭제

목록의 각 항목 우측에서 연필 아이콘으로 수정, 휴지통 아이콘으로 삭제할 수 있습니다. 삭제하면 저장된 토큰도 함께 제거되며, 다시 사용하려면 처음부터 인증 절차를 거쳐야 합니다.

토큰 만료 처리

OAuth 토큰이 만료되면 그리디가 저장된 refresh token으로 한 번 자동 갱신을 시도합니다. 갱신마저 실패하면 채팅에 오류가 표시되며, 이때는 커넥터를 다시 추가하면 됩니다.