MCP 연결
401 이 떠요 · 다시 로그인하라고 해요
토큰이 없거나, 폐기됐거나, 만료됐어요.
- 로그인으로 연결했다면 AI 앱에서 spear 연결을 다시 로그인해요 (Claude Code 는
/mcp) - 토큰으로 연결했다면 콘솔 팀 설정 › MCP 에서 새 토큰을 발급해 바꿔 넣어요. 폐기한 토큰은 되살릴 수 없어요
- 헤더가
Authorization: Bearer <토큰>모양인지, 토큰이sp_mcp_로 시작하는지 봐요
FORBIDDEN 이 떠요
그 팀의 멤버가 아니거나, 그 일을 할 권한이 없어요. 팀 관리자에게 초대나 권한을 요청해요.
PROJECT_REQUIRED 가 떠요
읽기 · 편집 멤버는 어느 프로젝트에서 할지 꼭 알려 줘야 해요. 에이전트에게 프로젝트 이름을 같이 말해 보세요.
PROJECT_NOT_FOUND · NOT_FOUND 가 떠요
그 프로젝트가 나에게 지정되지 않았거나, 다른 프로젝트의 것을 가리키고 있어요. 팀 관리자에게 프로젝트 지정을 요청하거나, 에이전트에게 프로젝트를 다시 고르게 해요.
403 이 떠요 (브라우저에서 직접 부를 때)
허용되지 않은 사이트에서 부르면 막혀요. AI 앱 · CLI · 서버에서 연결해요.
에이전트가 글을 발행하지 못해요
정상이에요. 에이전트는 글을 승인 대기까지만 만들어요. 콘솔에서 확인하고 사람이 발행해요.
채널 연결
| 메시지 | 할 일 |
|---|---|
| 연결을 취소했어요. | 승인 화면에서 취소한 거예요. 다시 연결하고 허용을 눌러요 |
| 연결 요청이 만료됐거나 잘못됐어요. 다시 시도하세요. | 연결을 처음부터 다시 해요 |
| 채널 연결은 팀 전체(FULL) 권한이 필요해요. | 팀 관리자에게 권한을 요청하거나 연결을 맡겨요 |
| 채널 앱 키가 없어요. | 사이드바 채널 · 연결 › 앱 키 에 팀 앱 키를 넣거나 관리자에게 문의해요 |
| 연결에 쓴 앱 키가 사라졌어요. 다시 연결하세요. | 채널 목록에서 다시 연결 을 눌러요 |
| 글을 올릴 수 있는 Facebook 페이지가 없어요. | 페이지 관리자 계정으로 연결하고, 승인 화면에서 페이지를 골라요 |
채널 상태가 다시 연결 로 바뀌었다면 연결이 끊겼거나 곧 끊긴다는 뜻이에요. 그 줄의 다시 연결 을 눌러요.
그래도 안 되면
문의하기 에 무엇을 했고 어떤 메시지가 떴는지 적어 주세요. 토큰 값은 적지 마세요.