문서
인증
REST API는 API 키로, AI 연결은 OAuth로 로그인해요. 두 방법은 따로 써요.
포샌디에 로그인하는 방법은 두 가지예요. 코드에서 REST API를 부를 때는 API 키를 쓰고, AI가 MCP로 연결할 때는 OAuth를 써요. 두 방법은 서로 섞이지 않아요.
API 키
API 키는 요청 헤더에 bearer 토큰으로 넣어요. 키마다 권한이 정해져 있어요. 읽기 권한만 있는 키로는 글을 올릴 수 없어요.
authorization: Bearer psd_live_...
키 원문은 한 번만 보여요. 포샌디는 키를 그대로 저장하지 않고 해시값만 저장해요. 그래서 잃어버리면 다시 볼 방법이 없어요. 기존 키를 폐기하고 새로 만들어요.
권한
| 이름 | 종류 | 하는 일 |
|---|---|---|
accounts:read | 읽기 | 연결된 채널 목록 보기 |
posts:read | 읽기 | 발행 기록, 댓글, 지표 보기 |
posts:write | 쓰기 | 발행, 삭제, 답글, 숨기기, 파일 올리기 |
offline_access | OAuth | 브라우저를 닫아도 AI 연결 유지 |
AI 연결용 OAuth
MCP를 쓰는 AI 앱은 스스로 클라이언트 등록을 하고 OAuth 2.1 + PKCE로 로그인해요. 사람은 브라우저에 뜬 승인 화면에서 허용만 누르면 돼요. 이 과정에서 API 키는 오가지 않아요. 자세한 순서는 MCP로 연결하기에 있어요.
자주 묻는 것
API 키와 OAuth 중 무엇을 써야 해요?
직접 짠 코드에서 REST API를 부르면 API 키를 써요. AI가 MCP로 연결하면 OAuth를 써요. AI 앱에 API 키를 붙여넣어도 연결에는 쓰이지 않아요.
API 키는 어디에 넣어요?
authorization 헤더에 bearer 토큰으로 넣어요. 쿼리 파라미터로 보낸 키는 받지 않아요. 주소에 붙은 값은 서버 로그와 브라우저 기록에 남기 때문이에요.
잃어버린 키를 다시 볼 수 있어요?
없어요. 포샌디에는 키 원문이 없고 해시값만 있어서 보여 드릴 수가 없어요. 쓰던 키를 폐기하고 새 키를 만들어요. 그다음 채널 연결로 넘어가요.