AI 앱에 연결하기

AI 앱이 Spear 를 읽고 쓰려면 MCP 로 연결해요. 쓰는 앱에 주소 하나를 넣고, 브라우저에 뜬 Spear 로그인 창에서 허용하면 끝이에요. 토큰은 필요 없어요.

연결할 주소는 이것 하나예요.

https://api.spear.im/mcp

주소와 앱별 순서는 콘솔 팀 설정 › MCP 의 AI 앱에 연결 카드에도 그대로 있어요.

Claude 앱 (claude.ai · Claude 데스크톱)

claude.ai 또는 Claude 데스크톱 왼쪽 메뉴에서 Customize › Connectors 를 열고 Add › Add custom connector 를 눌러요
이름에 Spear, 주소에 MCP 주소를 붙여 넣고 Continue, 그다음 Add 를 눌러요. 로그인 방식은 저절로 맞춰져요
Connect 를 누르면 Spear 「Claude 연결」 창이 열려요. 허용하면 끝이에요

팀 · 엔터프라이즈 요금제는 관리자가 먼저 추가해야 할 수 있어요
컴퓨터에서 한 번 연결하면 휴대폰 Claude 앱에서도 써요

ChatGPT

chatgpt.com 왼쪽 메뉴에서 Plugins 를 열고 오른쪽 위 Add › Add custom MCP server 를 눌러요
Name 에 Spear, Connection 의 Server URL 에 MCP 주소를 넣고 Authentication 은 OAuth 그대로 둬요. 안내를 읽고 「I understand and want to continue」 를 체크한 뒤 Create as a plugin 을 눌러요
Spear 로그인 창이 열리면 허용해요

업무용 워크스페이스는 관리자 설정에 따라 막혀 있을 수 있어요

Claude Code

터미널에서 실행해요

claude mcp add --transport http spear https://api.spear.im/mcp

Claude Code 안에서 /mcp 를 열고 spear 를 골라 인증해요
브라우저에 뜬 Spear 로그인 창에서 허용하면 끝이에요

Codex

터미널에서 서버를 추가해요

codex mcp add spear --url https://api.spear.im/mcp

로그인 명령을 실행해요
```
codex mcp login spear
```
브라우저에 뜬 Spear 로그인 창에서 허용하면 끝이에요

Cursor

Cursor 설정 › MCP › 새 서버 추가를 열어요

mcp.json 에 아래를 넣고 저장해요

{
  "mcpServers": {
    "spear": { "url": "https://api.spear.im/mcp" }
  }
}

서버 옆 로그인을 누르고 Spear 로그인 창에서 허용해요

그 밖의 앱

앱의 MCP 서버 추가 화면에서 종류를 원격(HTTP) 으로 골라요
주소에 MCP 주소를 넣어요. 로그인을 지원하는 앱이면 여기서 끝이에요
로그인을 지원하지 않는 앱이면 아래 봇 · CI 가 쓸 때 처럼 토큰을 발급해 Authorization: Bearer <토큰> 헤더로 넣어요

다 됐는지 확인

새 대화에서 이렇게 물어보세요.

Spear 에서 내 팀 목록 보여 줘

내 팀 이름이 나오면 연결된 거예요. 콘솔 팀 설정 › MCP 의 연결된 AI 앱 · 발급한 토큰 목록에도 앱 이름이 로그인 연결 로 떠요.

연결이 안 될 때

로그인 창이 안 떠요: 브라우저 팝업 차단을 풀고 다시 연결해요
회사 · 팀 요금제 앱이에요: 관리자가 커넥터 추가를 먼저 허용해야 할 수 있어요
다른 Spear 계정으로 로그인했어요: 콘솔 팀 설정 › MCP 목록에서 그 연결을 연결 끊기 하고, 맞는 계정으로 다시 연결해요
그 밖의 오류 메시지는 이럴 땐 어떻게 하나요

봇 · CI 가 쓸 때: 토큰으로 연결

브라우저가 없는 연결(봇 · CI · 서버)은 로그인 대신 토큰을 써요.

콘솔 팀 설정 › MCP › 봇·CI 용 토큰 에서 토큰 이름을 적고 발급 을 눌러요
토큰(sp_mcp_ 로 시작)은 이때 한 번만 보여요. 바로 복사해 비밀 저장소에 넣어요
연결해요

claude mcp add --transport http spear https://api.spear.im/mcp --header "Authorization: Bearer <토큰>"

연결 끊기

콘솔 팀 설정 › MCP 목록에서 연결 끊기(로그인 연결) 또는 폐기(토큰)를 눌러요. 그 즉시 그 연결로는 못 들어와요.

알아 둘 것

AI 앱은 연결한 사람의 권한으로 움직여요. 내가 못 하는 일은 AI 앱도 못 해요
AI 앱은 글을 준비됨까지만 만들어요. 발행은 사람이 콘솔에서 해요
로그인 연결은 1시간마다 저절로 갱신돼요. 봇 · CI 용 토큰은 폐기할 때까지 써요