에이전트

MCP 로 연결하기

쓰던 AI 에이전트에 uplika 를 붙입니다. 설치할 SDK 도, 붙여넣을 키도 없습니다.

uplika 는 원격 MCP 서버를 제공합니다. 에이전트가 주소만 알면 나머지는 클라이언트가 합니다. 동적 클라이언트 등록도, OAuth 2.1 + PKCE 도 그쪽 몫입니다.

사람이 하는 일은 둘입니다. 주소를 넣고, 브라우저에서 승인을 누르는 것.

서버 주소

https://api.uplika.com/mcp

클라이언트별

Claude
설정을 열고 사용자 정의 커넥터를 추가해 주소를 붙여넣은 뒤 승인합니다.
Claude Code
아래 프롬프트를 붙여넣으면 에이전트가 스스로 설정합니다.
OpenClaw
아래 프롬프트를 붙여넣으면 에이전트가 스스로 설정합니다.
Hermes
아래 프롬프트를 붙여넣으면 에이전트가 스스로 설정합니다.

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

1. Add this HTTP MCP server: claude mcp add --transport http 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 를 부르고 빈 계정 목록을 받은 뒤 하지도 않은 성공을 보고합니다.