공개 API

AI 어시스턴트 연결하기 (MCP)

어시스턴트에게 필요한 스코프만 담은 API 키를 만들고, 클라이언트에 https://api.mosaqo.app/v1/mcp 주소와 그 키를 bearer 토큰으로 건네세요. 어시스턴트는 키가 허용한 것만 할 수 있고 그 이상은 없으며, 언제든 Bulk & API에서 연결을 해제할 수 있습니다.

최종 검토 2026년 8월 20일

절차

1. Bulk & API → API keys 를 열고 키를 만드세요. 먼저 읽기 스코프만 주고, 쓰기 권한이 있는 두 번째 키는 어시스턴트가 무엇을 하는지 본 뒤에 발급하세요.
2. 같은 화면의 AI assistants (MCP) 패널에서 주소를 복사하세요.
3. 어시스턴트에 그 주소로 서버를 추가하고, 키는 Authorization: Bearer 헤더로 보내세요. 대부분의 클라이언트는 url 과 headers 가 든 JSON 블록을 받습니다.
4. 일부 커넥터는 키를 붙여넣는 대신 Mosaqo 로그인을 요구합니다. 그 경로는 무엇이든 허용되기 전에 누가 요청하는지, 어느 워크스페이스에 미치는지, 무엇을 할 수 있는지 보여줍니다 — 승인은 소유자나 관리자만 할 수 있습니다.
5. 어시스턴트에게 무엇을 할 수 있는지 물어보세요. 키가 허용하는 도구를 나열해 줍니다. 연결 범위가 의도대로인지 확인하는 가장 빠른 방법입니다.

결과 확인 방법

이 워크스페이스만 아는 것을 물어보세요. 코드가 몇 개인지, 설문이 어떻게 되고 있는지. 실제 이름과 숫자가 담긴 답이 오면 연결이 살아 있는 것이고, 스코프 이름을 든 거절이 오면 키가 질문보다 좁다는 뜻입니다.

흔히 어긋나는 지점

• 첫 키부터 쓰기 권한을 주는 것. 읽기로 시작하고, 무엇에 쓰이는지 알게 된 뒤 넓히세요.
• 설문에 사람들이 쓴 글을 읽어 줄 것이라 기대하는 것. 그 답변은 키에도 어시스턴트에도 전달되지 않습니다 — 점수와 건수는 되지만 문장은 인박스에 남습니다.
• 코드를 삭제해 줄 것이라 기대하는 것. 할 수 없습니다. 인쇄된 코드 뒤의 리디렉션을 없애는 일은 되돌릴 수 없어서, 대신 보관이 제공되고 그것은 되돌릴 수 있습니다.
• 연결을 잊는 것. 로그인으로 연결한 어시스턴트는 Bulk & API에서 해제할 때까지 접근을 유지합니다 — 키가 취소될 때까지 유효한 것과 같습니다.