nostr.build
모든 가이드

AI 에이전트 연결하기

AI 에이전트는 미디어 목록을 보고, 업로드하고, 정리하는 일을 대신해 줄 수 있습니다. 이 가이드에서는 토큰으로 접근 권한을 주는 방법, 어디까지 맡길지, 그리고 권한을 다시 거두는 방법을 안내합니다.

계정이 있는 모든 분께. 모든 요금제에서 쓸 수 있습니다.

그림은 휴대폰 화면입니다. 컴퓨터에서도 페이지는 같고 더 넓을 뿐입니다.

하는 일

  • Claude Code, Codex, Cursor, Gemini CLI 같은 앱은 MCP로 내 계정에 연결할 수 있습니다. MCP는 AI 에이전트가 다른 서비스를 쓰는 표준 방식입니다.
  • 연결한 뒤에는 평소 말투로 에이전트에게 부탁하면 됩니다. 예를 들어 휴가 사진을 새 폴더로 옮기거나 파일에 제목과 설명을 달아 달라고 할 수 있습니다.
  • 에이전트는 토큰으로 들어옵니다. 토큰은 직접 만드는 긴 비밀 코드입니다. 토큰을 가진 사람은 그 액세스 수준이 허용하는 일을 내 계정에서 무엇이든 할 수 있으니, 비밀번호처럼 남에게 보여 주지 마세요.

토큰 만들기

  1. 페이지 위쪽의 로봇 버튼(연결된 에이전트)을 탭하세요.
  2. 새 토큰 버튼을 탭하세요.
  3. 라벨 칸에 나중에 알아볼 수 있는 이름을 입력하세요. 앱 이름이면 좋습니다.
  4. 액세스 수준 항목에서 하나를 고르고(아래에서 자세히 설명합니다) 토큰 생성 버튼을 탭하세요.
연결된 에이전트에서 새 토큰을 만드는 화면: 이름과 세 가지 액세스 수준.

에이전트에게 넘겨주기

  1. 이제 토큰이 생성되었습니다 화면이 보입니다. 설정 메시지 복사 버튼을 탭하세요.
  2. 에이전트와의 채팅에 메시지를 붙여넣고 보내세요. Claude Code나 Codex처럼 명령을 실행할 수 있는 에이전트는 설정 페이지를 읽고 연결을 스스로 추가합니다. 일부는 다시 시작해야 연결을 쓸 수 있습니다.
  3. 에이전트가 연결되면 완료 버튼을 탭하세요.

앱을 직접 설정하나요? MCP 엔드포인트 버튼을 탭해 주소를 복사하고, 토큰 복사 버튼으로 토큰을 앱에 넣으세요. Claude Code, Codex, Cursor, Gemini CLI 등의 설정은 account.nostr.build/agent-setup.md에 있습니다(영어).

토큰이 만들어진 화면: 토큰, 복사 버튼, 한 줄짜리 설정 메시지.

또는 연결 코드 승인하기

스스로 연결을 요청하는 에이전트도 있습니다. 에이전트가 짧은 코드(예: ABCD-2345)와 링크를 보여 줍니다.

  1. 먼저 로그인한 다음 링크를 여세요. 코드가 자동으로 채워집니다. 또는 연결된 에이전트 화면에서 승인하기 버튼을 탭하고 연결 코드 칸에 코드를 입력하세요. 그다음 계속 버튼을 탭하세요.
  2. 에이전트 이름과 요청한 권한을 확인하세요. 더 적게 줄 수는 있지만 더 많이 줄 수는 없습니다.
  3. 승인 버튼을 탭하세요. 에이전트가 토큰을 알아서 받으며, 토큰은 나에게 보이지 않습니다. 그다음 연결된 에이전트 목록에 나타납니다.
에이전트 연결: 에이전트 이름, 요청한 권한, 내 에이전트만 승인하라는 경고.

알맞은 액세스 수준 고르기

  • 읽기 전용: 에이전트가 폴더, 파일, 계정, 알림을 볼 수 있고 아무것도 바꾸지 않습니다.
  • 읽기 및 쓰기: 여기에 더해 업로드, 폴더 만들기, 파일 옮기기, 제목과 설명 편집, 동영상 커버 이미지 설정을 할 수 있습니다. AI Studio가 포함된 요금제에서는 AI 이미지도 만들 수 있으며, 유료 모델은 AI 크레딧을 사용합니다.
  • 삭제를 포함한 전체 액세스: 여기에 더해 파일과 폴더를 삭제할 수 있습니다. 폴더를 삭제하면 안의 파일은 홈으로 옮겨지지만, 에이전트는 안에 든 것까지 폴더째 삭제할 수도 있습니다. 삭제한 파일은 되살릴 수 없습니다.

토큰 확인하고 해제하기

  1. 연결된 에이전트 화면을 여세요. 토큰마다 이름, 액세스 수준, 만든 시각, 마지막으로 쓴 시각과 그때의 IP 주소 및 앱이 표시됩니다(아직 쓰지 않았다면 사용한 적 없음). 이 정보는 최대 한 시간에 한 번 업데이트됩니다.
  2. 토큰 옆의 해제 버튼을 탭한 뒤 확인을 위해 해제 버튼을 한 번 더 탭하세요. 그 토큰을 쓰는 에이전트는 즉시 권한을 잃습니다. 이미 시작된 폴더 삭제는 그대로 끝까지 진행됩니다.

토큰은 저절로 만료되지 않으니 더 이상 쓰지 않는 토큰은 해제하세요. 토큰의 이름과 액세스 수준은 바꿀 수 없습니다. 새 토큰을 만들고 예전 토큰을 해제하세요.

이 토큰을 해제할까요? 에이전트가 즉시 권한을 잃는다는 경고.

그래도 해결되지 않나요? 문제가 생겼을 때 가이드에서 흔한 오류 메시지를 설명하고, 도움 받기 가이드에서 팀에 연락하는 방법을 알려 드립니다.