POSENDY
시작하기

문서

MCP로 연결하기

쓰던 AI에 포샌디를 연결해요. 따로 설치할 프로그램도, 붙여넣을 키도 없어요.

포샌디는 원격 MCP 서버를 제공해요. AI에 서버 주소만 알려주면 나머지 연결 과정은 AI 앱이 알아서 처리해요. 클라이언트 등록과 OAuth 2.1 + PKCE 인증도 AI 앱 쪽에서 해요.

사람이 할 일은 두 가지예요. 주소를 넣고, 브라우저에 뜬 승인 화면에서 허용을 누르는 것.

API 키는 필요 없어요. MCP 연결은 OAuth로 로그인해요. API 키는 개발자가 REST API를 직접 부를 때만 써요. 인증 방법이 두 가지라 여기서 많이 헷갈려요.

서버 주소

아래 주소를 AI 앱의 MCP 서버 칸에 넣어요.

https://api.posendy.com/mcp

AI 앱별 연결 방법

  1. Codex: 아래 문장을 붙여넣으면 Codex가 포샌디를 전역 설정에 추가해요. 어느 폴더에서 열어도 쓸 수 있어요.
  2. ChatGPT: 앱 목록에 올라가기 전까지는 '사용자 지정 MCP 서버'로 추가해요. 개발자 모드는 켜지 않아도 돼요. 플러그인 화면에서 추가를 누르고, 이름과 위 서버 주소를 넣고, 인증은 OAuth 그대로 둔 채 확인란에 체크한 다음 '플러그인으로 생성'을 눌러요. 그다음 로그인해서 승인해요.
  3. Claude: 이름과 주소가 미리 채워진 Claude 추가 화면에서 '추가'를 누르고 승인해요. 직접 넣으려면 설정 > 커넥터 > 사용자 정의 커넥터 추가에 주소를 붙여넣어요.
  4. Claude Code: 아래 문장을 붙여넣으면 Claude Code가 포샌디를 전역 설정에 추가해요.
  5. OpenClaw: 아래 문장을 붙여넣으면 OpenClaw가 포샌디를 전역 설정에 추가해요.
  6. Hermes: 아래 문장을 붙여넣으면 Hermes가 포샌디를 전역 설정에 추가해요.

Claude Code에 붙여넣는 문장은 이렇게 생겼어요.

Set up posendy so I can post to social media from right here.

1. Install the posendy plugin (it adds the posendy MCP server and its skills) by running:
   claude plugin marketplace add posendy/posendy-plugin
   claude plugin install posendy@posendy --scope user
2. Reload plugins, or tell me to restart this session, so the posendy tools load.
3. Call list_accounts. When the approval screen opens in my browser, walk me through clicking Allow to finish.
4. Then list my connected social accounts so we can confirm it worked.

Tell me when it's done.

AI 앱마다 자세한 화면은 AI별 연결에 있어요.

플러그인으로 설치

플러그인은 같은 MCP 서버에 '도구를 어떤 순서로 부르면 되는지' 요령을 더한 묶음이에요. 터미널을 쓰는 AI는 아래 명령을 직접 실행해요. 주소만 추가하는 방법도 똑같이 작동해요.

codex plugin marketplace add posendy/posendy-plugin
codex plugin add posendy@posendy

승인할 때 허용하는 권한

이름종류하는 일
accounts:read읽기연결된 채널 목록 보기
posts:read읽기올린 글 기록, 댓글, 숫자 보기
posts:write쓰기글 올리기, 지우기, 답글 달기, 숨기기, 파일 올리기
offline_access로그인 유지브라우저를 닫아도 AI 연결 유지

승인 화면에는 이 4가지만 나와요. 그 밖의 정보는 넘어가지 않고, 연결은 대시보드에서 언제든 끊을 수 있어요.

승인 전에 채널을 먼저 골라요. 연결된 채널이 하나도 없으면 승인이 멈추고 채널부터 연결하라고 안내해요. 올릴 곳이 없는 상태로 연결되면, AI는 글을 올렸다고 착각할 수 있어요.

연결은 됐는데 이상할 때

문의가 가장 많은 경우 4가지예요.

증상이유해결
도구 목록이 비어 있어요채널을 아직 고르지 않았어요승인 화면에서 채널을 하나 이상 고르고 승인해요. 그러면 도구가 보여요.
승인을 계속 다시 요구해요AI 앱이 실패한 승인 기록을 저장해 뒀어요AI 앱에서 커넥터를 지우고 다시 추가해요.
발행하면 no_accounts가 나와요어느 채널에 올릴지 정보가 빠졌어요select_channels를 먼저 불러요. publish에 넣을 계정 id를 알려줘요.
도구가 일부만 보여요승인할 때 권한을 좁게 골랐어요다시 승인하고 권한을 기본값 그대로 둬요. 읽기 권한만 있으면 발행 도구가 안 보여요.

더 많은 경우는 안 될 때에 있어요.

자주 묻는 것

AI를 연결하는 데 API 키가 필요한가요?

아니요. MCP는 OAuth로 로그인하고, AI 앱이 스스로 등록해요. API 키는 REST API를 직접 부를 때만 써요.

어떤 AI에서 쓸 수 있어요?

HTTP MCP와 OAuth를 지원하는 AI 앱이면 돼요. 위에 적은 6개는 처음부터 끝까지 직접 확인한 앱이고, 목록에 없는 앱도 연결 방법은 같아요.

승인이 멈추고 채널을 연결하라고 해요

연결된 채널이 없으면 AI가 올릴 곳이 없어서 그래요. 대시보드의 연결 화면에서 채널을 하나 이상 연결한 다음 다시 승인해요. 방법은 채널 연결에 있어요.

다음Quickstart