Nubbo MCP 서버를 사용하면 AI 어시스턴트가 대화 안에서 내 파일을 다룰 수 있어요. 이 가이드에서는 Claude, ChatGPT 또는 Cursor에 연결하고 첫 작업을 요청해요.
제공되는 기능
- 내 말로 파일 찾기, 링크나 인박스 만들기, 폴더 정리를 요청해요.
- 연결할 때 공간, 권한, 사용할 수 있는 버킷이나 프로젝트를 선택해요.
- 어시스턴트가 한 모든 일을 어시스턴트 키 이름과 함께 활동에서 확인해요.
시작하기 전에
Pro 또는 팀 요금제의 Nubbo 계정과 사용자 지정 커넥터를 쓸 수 있는 요금제의 Claude, ChatGPT 또는 Cursor가 필요해요. 팀에서는 소유자와 관리자만 어시스턴트를 연결할 수 있어요.
1단계: 서버 주소 복사하기
Nubbo에서 설정 › API(팀이라면 팀 › API)를 열고 MCP 서버 카드의 주소를 복사하세요: https://api.nubbo.app/mcp.

2단계: 커넥터 추가하기
어시스턴트의 메뉴가 사용 중인 언어로 표시될 수 있어요.
Claude. Customize › Connectors를 열고 **+**와 Add custom connector를 누르세요. 이름에 Nubbo를 입력하고 주소를 붙여 넣은 뒤 Add까지 단계를 진행하세요. Claude의 Team 및 Enterprise 요금제에서는 조직 소유자가 Organization settings › Connectors에서 추가하고 각 사용자가 Connect를 눌러요.

ChatGPT. chatgpt.com/plugins를 열고 **+**와 Add custom MCP server를 누르세요. 이름에 Nubbo를 입력하고 Server URL에 주소를 붙여 넣은 뒤 OAuth를 선택하고 플러그인을 만드세요. 그다음 설치하고 채팅에서 @Nubbo를 입력해 사용하세요.
Cursor. Cursor는 API 키로 연결해요. API 가이드처럼 설정 › API에서 키를 만들고 ~/.cursor/mcp.json에 서버를 추가하세요.
{
"mcpServers": {
"nubbo": {
"url": "https://api.nubbo.app/mcp",
"headers": { "Authorization": "Bearer nbk_your_key" }
}
}
}
3단계: Nubbo에 로그인하기
Claude와 ChatGPT에서는 연결할 때 Nubbo가 Claude을(를) Nubbo에 연결(또는 사용하는 어시스턴트 이름) 화면으로 열려요.
- 공간을 선택하세요: 개인 공간이나 내 팀 중 하나.
- 권한을 선택하세요. 기본값은 읽기 전용이에요. 항목을 만들거나 옮길 수 있게 하려면 읽기 및 쓰기로 바꾸세요.
- 범위를 선택하세요: 공간 전체 또는 선택한 버킷과 프로젝트.
- 연결을 누르고 비밀번호(2단계 인증을 사용한다면 코드도)로 확인하세요. Nubbo가 어시스턴트로 다시 보내 줘요.

4단계: 무언가 요청하기
필요한 것을 입력하세요. 예를 들어: “Nubbo에서 Catalog-2026 폴더의 사진을 찾고 spring-cover.jpg를 공유하는 링크를 7일 후 만료되도록 만들어 줘”. 무언가를 바꾸는 도구를 쓰기 전에 어시스턴트가 허락을 구할 수 있어요.


5단계: 권한 확인하거나 취소하기
설정 › API(또는 팀 › API)에서 어시스턴트의 키가 Claude와(과) 연결됨(또는 앱 이름)으로 표시돼요. 메뉴에서 바로 권한을 취소할 수 있어요.

문제가 생겼을 때
| 상황 | 해결 방법 |
|---|---|
| “이 팀의 API 키를 관리할 권한이 필요해요.” | 소유자나 관리자에게 어시스턴트를 연결해 달라고 하거나, 개인 공간을 선택하세요. |
| “이 공간에는 요금제에서 허용하는 API 키가 이미 모두 있어요.” | 설정 › API(또는 팀 › API)에서 사용하지 않는 키를 취소하고 다시 연결하세요. |
| “요청이 만료되었어요” | 어시스턴트에서 Nubbo를 다시 연결하세요. |
| 어시스턴트가 아무것도 바꿀 수 없다고 해요 | 연결이 읽기 전용이에요. 설정 › API(또는 팀 › API)에서 키 메뉴를 열고 편집을 눌러 읽기 및 쓰기를 선택하세요. |
AI 어시스턴트 안의 Nubbo에 대해 더 알아보세요. 내 코드로 자동화하려면 API 가이드를 따라 하세요.
자주 묻는 질문
어시스턴트가 암호화된 파일을 읽을 수 있나요?
아니요. Nubbo는 암호화된 콘텐츠를 절대 읽지 않으며 어시스턴트에게 넘기지도 않아요. 열려면 어시스턴트가 Nubbo로 안내해요.
어시스턴트는 무엇을 할 수 있나요?
파일을 찾고, 읽고, 정리하고, 링크와 인박스를 만들 수 있어요. 항상 연결할 때 선택한 권한 안에서만 해요. 읽기 전용이면 아무것도 바꿀 수 없어요.
API 사용량으로 집계되나요?
네. 어시스턴트가 사용하는 도구는 공간의 API 요청으로 집계돼요.
사용하지 않으면 어떻게 되나요?
90일 동안 사용하지 않으면 연결이 자동으로 끝나요. 다시 사용하려면 어시스턴트에서 Nubbo를 다시 연결하세요.
출처
단계는 아래 페이지로 확인했어요.