커넥터

• —커넥터는 외부 앱을 어시스턴트에 연결해, 어시스턴트가 그 앱에서 정보를 찾고 작업할 수 있게 합니다. Slack, Notion, Google Drive, HubSpot을 비롯해 그 밖에 약 천 개의 앱을 연결할 수 있습니다. “Drive에서 제안서를 찾아서 가격에 대해 뭐라고 적혀 있는지 알려 줘.” “이 업데이트를 영업 채널에 올려 줘.” 커넥터는 사이드바의 커넥터에 있습니다.
• —앱을 연결하려면 목록에서 앱을 고르고, 누구를 위한 것인지와 어시스턴트가 할 수 있는 일을 선택한 다음, 앱 자체의 로그인 페이지에서 마치거나 그 페이지에 앱의 키를 붙여 넣으세요. 비밀번호나 키는 OpenEmail의 채팅, API, 어시스턴트를 절대 거치지 않습니다. 커넥터는 마칠 때까지 대기 중이고, 그 뒤에는 활성 상태가 됩니다.
• —커넥터는 나만을 위한 것이거나 워크스페이스 전체를 위한 것이며, 어시스턴트는 커넥터를 통해 정보를 찾기만 하거나 변경도 할 수 있습니다. 이는 나중에 바꿀 수 있고, 커넥터를 일시 중지했다가 재개할 수도 있습니다. 연결을 해제하면 외부 앱에서도 액세스를 내려놓습니다. 앱이 연결을 더 이상 받아들이지 않으면 커넥터가 다시 연결해 달라고 요청하며, 새 링크를 쓰면 같은 커넥터 그대로 되돌아옵니다.
• —채팅에서 어시스턴트는 무엇이 연결되어 있는지 확인하고, 앱에서 알맞은 작업을 찾아 바로 읽습니다. 메시지 보내기, 레코드 만들기나 업데이트, 삭제처럼 앱에서 무언가를 변경하는 일은 사용자가 직접 요청했더라도 먼저 사용자가 승인할 카드를 보여 줍니다. 정보를 찾기만 하는 커넥터는 변경을 거부하며, 앱이 돌려주는 내용은 정보로만 다루고 지시로는 절대 다루지 않습니다.
• —태스크는 그 태스크의 추가 도구에서 커넥터를 켰을 때만 커넥터를 사용하며, 워크스페이스용으로 연결된 커넥터만 사용하고 한 사람의 것인 커넥터는 절대 사용하지 않습니다. 읽기는 알아서 합니다. 앱에서의 모든 변경은 태스크가 그 밖에 무엇을 알아서 할 수 있든 승인 대기에서 기다리며, 커넥터를 사용하는 태스크는 절대 스스로 메일에 답장하지 않습니다. 모든 답장은 사용자의 승인을 기다립니다.
• —커넥터를 통한 모든 호출은 90일 동안 기록됩니다. 언제였는지, 어떤 앱의 어떤 작업인지, 무언가를 읽었는지 변경했는지, 성공했는지, 그리고 채팅, 태스크, API, 에이전트 중 어디에서 왔는지가 남습니다. 앱에 보낸 내용과 앱에서 돌아온 내용은 OpenEmail이 절대 보관하지 않습니다.
• —누가 무엇을 하는지는 세 가지 권한으로 정해집니다. 커넥터와 이를 통해 이루어진 일을 보는 권한, 어시스턴트가 커넥터를 사용하게 하는 권한, 그리고 앱을 연결, 일시 중지, 연결 해제하고 어시스턴트가 할 수 있는 일을 설정하는 권한입니다. 소유자와 관리자는 세 가지를 모두 가지고, Member는 앞의 두 가지를, Viewer는 첫 번째를 가집니다. 앱을 연결할 수 있는 사람은 자신을 위해서도, 워크스페이스를 위해서도 연결할 수 있습니다.
• —요금제별 커넥터 수는 계정 하나에 Free에서 2개, Starter에서 10개, Business에서 50개이며, 워크스페이스에도 같은 수만큼 더 둘 수 있습니다. Enterprise는 자체 한도를 두지 않지만, 어떤 경우에도 200개를 넘을 수 없습니다. 워크스페이스가 더 작은 요금제로 옮기면 한도를 넘는 커넥터는 최신 것부터 일시 중지되며, 제거되지는 않습니다.
• —연결은 외부 제공업체가 보관하며, 이 제공업체는 어시스턴트가 앱에 보내는 내용과 앱이 응답하는 내용의 기록도 최대 1년간 보관합니다. 이 제공업체는 개인정보 처리방침 페이지에 나와 있습니다.
• —커넥터는 REST API의 /connectors, /connector-apps, /connector-categories, /connector-calls, 모든 SDK의 connectors, 명령줄의 openemail connectors, 그리고 MCP 서버에서 쓸 수 있습니다. API에서는 변경이 아무에게도 묻지 않고 바로 실행되므로, 결정은 호출자의 몫입니다. 웹훅 이벤트 세 개가 워크스페이스 커넥터가 연결될 때, 연결이 해제될 때, 다시 연결해야 할 때 사용자의 시스템에 알려 줍니다.

연결은 1분이면 되고, 로그인은 앱 자체의 페이지에서 이루어집니다.

1. 1사이드바에서 커넥터를 열고 둘러보기에서 이름이나 카테고리로 앱을 찾으세요.
2. 2커넥터가 누구를 위한 것인지 선택하세요. 나만 또는 워크스페이스 전체입니다.
3. 3어시스턴트가 커넥터를 통해 할 수 있는 일을 선택하세요. 정보를 찾기만 하거나, 변경도 할 수 있습니다.
4. 4앱의 로그인 페이지에서 마치거나 그 페이지에 앱의 키를 붙여 넣으세요. 커넥터는 마칠 때까지 대기 중이고, 그 뒤에는 활성 상태가 됩니다.

• —앱의 비밀번호나 키는 OpenEmail의 채팅, API, 어시스턴트를 절대 거치지 않습니다.
• —앱이 연결을 더 이상 받아들이지 않으면 커넥터가 다시 연결해야 한다고 알려 줍니다. 새 링크를 쓰면 같은 커넥터 그대로 되돌아오므로, 그 커넥터를 사용하는 태스크는 계속 동작합니다.
• —어시스턴트가 커넥터를 사용하지 못하게 하려면 일시 중지하고, 다시 쓰고 싶을 때 재개하세요.
• —연결을 해제하면 커넥터가 제거되고, 커넥터가 외부 앱에서 가지고 있던 액세스도 내려놓습니다.
• —커넥터는 서비스 전체에서 꺼져 있을 수 있습니다. 그러면 커넥터 페이지는 숨겨집니다.

• —소유자와 관리자는 세 가지를 모두 가집니다. 기본 제공 Member 역할은 connectors:read와 connectors:use를, Viewer는 connectors:read를 가집니다.
• —같은 권한이 두 종류의 커넥터에 모두 적용됩니다. 앱을 연결할 수 있는 사람은 자신을 위해서도, 워크스페이스를 위해서도 연결할 수 있습니다.

커넥터는 REST API의 /connectors, /connector-apps, /connector-categories, /connector-calls 아래, 모든 SDK와 CLI의 connectors 아래, 그리고 MCP 도구에 있으며, MCP 도구는 어시스턴트도 사용합니다.