에이전트
MCP 로 연결하기
쓰던 AI 에이전트에 uplika 를 붙입니다. 설치할 SDK 도, 붙여넣을 키도 없습니다.
uplika 는 원격 MCP 서버를 제공합니다. 에이전트가 주소만 알면 나머지는 클라이언트가 합니다. 동적 클라이언트 등록도, OAuth 2.1 + PKCE 도 그쪽 몫입니다.
사람이 하는 일은 둘입니다. 주소를 넣고, 브라우저에서 승인을 누르는 것.
서버 주소
https://api.uplika.com/mcp
클라이언트별
Codex
아래 프롬프트를 붙여넣으면 에이전트가 uplika 를 전역 설정에 추가합니다. 어느 폴더에서 열어도 보입니다.
ChatGPT
ChatGPT 앱 디렉터리에 오르기 전까지는 개발자 모드로 추가합니다. 설정 → 보안 및 로그인 → 개발자 모드를 켜고, 플러그인 → 플러그인 추가(+) → 앱 만들기 → MCP 앱 만들기에서 위 서버 주소와 OAuth 로 만든 뒤 로그인해 승인합니다. 그다음에는 휴대폰 ChatGPT 앱에서도 됩니다.
Claude
대시보드의 버튼을 누르면 이름과 주소가 채워진 Claude 추가 창이 열립니다. 「추가」 를 누르고 승인합니다. 직접 넣으려면 맞춤 설정 → 커넥터 → 사용자 정의 커넥터 추가에 주소를 붙여넣습니다.
Claude Code
아래 프롬프트를 붙여넣으면 에이전트가 uplika 를 전역 설정에 추가합니다. 어느 폴더에서 열어도 보입니다.
OpenClaw
아래 프롬프트를 붙여넣으면 에이전트가 uplika 를 전역 설정에 추가합니다. 어느 폴더에서 열어도 보입니다.
Hermes
아래 프롬프트를 붙여넣으면 에이전트가 uplika 를 전역 설정에 추가합니다. 어느 폴더에서 열어도 보입니다.
Set up uplika so I can post to social media from right here. 1. Add this HTTP MCP server at user (global) scope, so it works in every project and not just this folder: claude mcp add --transport http --scope user uplika https://api.uplika.com/mcp 2. When the approval screen opens in my browser, walk me through clicking Allow to finish. 3. Then list my connected social accounts so we can confirm it worked. Tell me when it's done.
무엇을 허용하는가
| 이름 | 타입 | 설명 |
|---|---|---|
accounts:read | read | List connected channels. |
posts:read | read | Read publishing history, replies and insights. |
posts:write | write | Publish, delete, reply, hide and upload. |
offline_access | oauth | Keep the agent connected after the browser closes. |
승인 화면에 정확히 이것만 뜹니다. 그 밖에는 아무것도 넘어가지 않고, 대시보드에서 언제든 끊을 수 있습니다.
붙긴 했는데 뭔가 이상합니다
제보의 대부분이 이 넷입니다. 넷 다 우리 쪽에서 고칠 것이 없는 경우입니다.
| 도구 목록이 비어 있습니다 | 채널을 아직 안 골랐습니다 | 동의 화면에서 채널을 하나 이상 고르고 승인하세요. 토큰이 생기면 도구가 나타납니다. |
|---|---|---|
| 인가를 계속 다시 요구합니다 | 클라이언트가 실패한 인가를 캐시했습니다 | 클라이언트에서 커넥터를 지우고 다시 등록하세요. 우리 쪽에는 지울 중간 상태가 없습니다. |
| 발행이 no_accounts 로 거절됩니다 | 어느 채널인지 안 실렸습니다 | select_channels 를 먼저 부르세요. publish 가 기대하는 계정 id 를 돌려줍니다. |
| 도구가 일부만 보입니다 | 승인 범위를 좁게 골랐습니다 | 다시 인가하고 스코프를 오는 대로 두세요. 읽기 전용 토큰에는 발행 도구가 없습니다. |
자주 묻는 것
에이전트를 붙이는 데 API 키가 필요한가요?
아닙니다. MCP 는 OAuth 로 인증하고 클라이언트가 스스로 등록합니다. API 키는 REST 를 직접 부를 때만 쓰는 것이라 에이전트에 넣을 일이 없습니다.
어떤 에이전트가 붙나요?
HTTP MCP 와 OAuth 를 말하는 클라이언트면 됩니다. 여기 적어 둔 것은 우리가 처음부터 끝까지 확인해 본 것들이고, 목록에 없는 클라이언트도 붙는 방법은 같습니다.
승인이 멈추고 채널을 연결하라고 하는데요?
뒤에 채널이 없는 토큰은 아무 데도 못 올리기 때문입니다. 그대로 두면 에이전트가 publish 를 부르고 빈 계정 목록을 받은 뒤 하지도 않은 성공을 보고합니다.