AI 어시스턴트 연결하기

AI Studio에는 모든 MCP 클라이언트가 연결할 수 있는 하나의 MCP 엔드포인트가 있습니다. 연결하면 AI 어시스턴트가 대시보드에서 작업하는 것과 같은 방식으로 워크스페이스에서 작업할 수 있습니다. 에이전트를 찾고, 만들고, 게시하고, 실행하고, 실행 기록을 읽고, 크레딧을 확인할 수 있습니다. 이 페이지에서는 연결 정보를 어디에서 찾을 수 있는지와 무엇을 예상할 수 있는지 보여줍니다.

연결 정보 찾기#

AI Studio 사이드바에서 Connect your AI를 여세요. 페이지 제목은 Connect your AI assistant이며 다음을 보여줍니다:

• MCP server URL과 Copy URL 버튼.
• 선택한 클라이언트에 대한 설정 단계가 포함된 Client 선택기. 페이지에는 Claude, ChatGPT, Cursor가 명시되어 있고, 선택기에는 Claude Code, Codex, Gemini, VS Code, Windsurf, Warp와 같은 클라이언트도 나열됩니다.
• What your agent can do, 엔드포인트가 제공하는 도구 그룹 목록.
• Connected clients, 현재 이 워크스페이스에 로그인한 AI 클라이언트.

소유자, 관리자, 편집자, 멤버는 이 페이지를 열 수 있습니다. 게스트와 유지보수 담당자는 열 수 없습니다.

클라이언트 연결하기#

1. URL 복사하기

   Connect your AI assistant 페이지에서 Copy URL을 클릭하세요.

2. 클라이언트에 추가하기

   Client 선택기에서 클라이언트를 선택하고 표시된 단계를 따르세요. 예를 들어 Claude Code에서는 터미널에서 claude mcp add --transport http로 URL을 등록합니다. Claude와 ChatGPT에서는 사용자 지정 커넥터로 추가합니다.

3. 로그인하고 워크스페이스 선택하기

   클라이언트가 브라우저 창을 엽니다. FlowHunt에 로그인하고 동의 화면에서 워크스페이스를 선택하세요.

4. 허용할 항목 선택하기

   읽기 전용 접근이 기본으로 부여됩니다. 어시스턴트가 항목을 만들고, 편집하고, 게시하고, 삭제하거나 실행해야 한다면 쓰기 옵션을 선택하세요. 지출 정보와 채팅 기록에 대해서는 별도의 옵션이 있습니다.

연결은 OAuth를 사용하므로 복사할 키가 없습니다. 워크스페이스 API 키도 엔드포인트에 대해 작동하지만, 페이지가 안내하는 경로는 로그인 방식입니다. API 키를 참고하세요.

어시스턴트가 할 수 있는 일#

도구는 영역별로 그룹화되어 있습니다. 쉽게 말해, 어시스턴트는 다음을 할 수 있습니다:

• 에이전트와 워크플로를 만들고, 찾고, 편집하고, 게시하고, 삭제하며 이전 버전을 복원합니다;
• 에이전트를 실행하고, 결과를 읽고, 실행을 중지하며, 실행을 예약합니다;
• 입력 테이블에 대해 에이전트를 실행하고 결과를 내보냅니다;
• 템플릿을 둘러보고 템플릿에서 에이전트를 시작합니다;
• 챗봇, 에이전트 그리드, 지식 소스, AI 프로젝트를 관리합니다;
• 채팅 기록, 오류, 도구 호출을 읽고 크레딧 잔액과 지출을 확인합니다;
• 워크스페이스 모델을 선택하고 어떤 통합이 연결되어 있는지 확인합니다.

대시보드에서 여러분의 역할이 허용하는 것만 할 수 있습니다. 크레딧과 요금제 한도도 적용되므로, 잔액이 비어 있으면 에이전트를 읽고 삭제할 수는 있지만 만들고, 편집하고, 게시하거나 실행할 수는 없습니다.

워크스페이스는 고정되어 있습니다#

연결은 동의 화면에서 선택한 워크스페이스에 바인딩됩니다. 어떤 도구도 워크스페이스를 인자로 받지 않으므로, 어시스턴트는 다른 워크스페이스에 접근할 수 없습니다. 다른 워크스페이스에서 작업하려면 다시 연결하고 해당 워크스페이스를 선택하세요.

에이전트 실행에는 크레딧이 듭니다#

어시스턴트가 에이전트를 실행하면 그 실행은 워크스페이스의 크레딧을 사용하고 연결된 서비스에서 작업할 수 있습니다. 예를 들어 이메일을 보내거나 Slack에 게시할 수 있습니다. 신뢰하는 어시스턴트에만 실행을 허용하고, 클라이언트의 확인 프롬프트를 켜 두세요. 크레딧을 참고하세요.

또한 엔드포인트는 워크스페이스가 시간당 수행할 수 있는 도구 호출 수를 제한합니다. 한도는 요금제에 따라 다르며, 권한이 없어 거부된 호출은 계산되지 않습니다.

어시스턴트가 이 문서를 읽게 하기#

엔드포인트에는 두 가지 문서 도구가 포함되어 있습니다. search_docs는 키워드로 AI Studio 문서에서 페이지를 찾고, get_docs_page는 /docs/agents/tools/와 같은 경로에서 페이지를 Markdown으로 반환합니다. 이들은 워크스페이스 데이터를 건드리지 않으므로, 어시스턴트는 무언가를 변경하기 전에 기능이 어떻게 작동하는지 물어볼 수 있습니다.

연결 확인 및 해지하기#

같은 페이지의 Connected clients에는 각 클라이언트와 연결한 시간이 나열됩니다. 소유자, 관리자, 편집자는 Revoke를 클릭한 다음 Confirm revoke를 클릭하여 클라이언트를 차단할 수 있습니다. 멤버는 목록을 볼 수 있지만 해지할 수는 없습니다. 제거된 멤버 또는 요금제 다운그레이드는 다음 호출 시 연결을 차단합니다.

직접 호스팅하는 도구를 다른 클라이언트에서 사용하고 싶으신가요? 호스팅 MCP 서버를 참고하세요.