AI 어시스턴트에서 Pickshot 쓰기 (MCP)
Pickshot의 MCP 서버를 쓰면 AI 어시스턴트가 내 계정으로 그림, 영상, 소리를 만들고 포토 앱을 실행하고 캐릭터를 보관할 수 있어요. 개발자 페이지의 API 키로 연결하거나, 로그인 연결만 되는 앱은 Pickshot 로그인으로 연결해요. 만들 때마다 크레딧이 들고, 유료 호출에는 가격 한도가 꼭 있어야 해요.
준비물
- 크레딧이 있는 Pickshot 계정.
- API 키(API 페이지에서 만들고 비공개로 보관해요) 또는 로그인(OAuth) 연결이 되는 앱.
- API 키를 쓸 때는 요청 헤더를 보낼 수 있는 MCP 클라이언트. 아래 설정은 네 가지를 다뤄요.
서버
주소 하나, HTTP 위의 표준 MCP예요. 내 쪽에 따로 설치할 것은 없어요.
| 서버 주소 | https://pickshot.ai/mcp |
|---|---|
| 전송 방식 | Streamable HTTP (상태 없음, JSON 응답) |
| 인증 | Authorization: Bearer <내 API 키> 또는 아래의 로그인(OAuth) 연결 |
API 키로 설정하기
YOUR_PICKSHOT_API_KEY 자리에 내 키를 넣으세요. 앱이 허용하면 환경 변수나 비밀 저장소에 두고, 공유하는 파일에는 넣지 마세요.
Claude Code
터미널에서 한 번만 실행하세요:
claude mcp add --transport http pickshot https://pickshot.ai/mcp \
--header "Authorization: Bearer YOUR_PICKSHOT_API_KEY"Cursor
서버를 ~/.cursor/mcp.json(모든 프로젝트) 또는 .cursor/mcp.json(한 프로젝트)에 추가하세요:
{
"mcpServers": {
"pickshot": {
"url": "https://pickshot.ai/mcp",
"headers": {
"Authorization": "Bearer YOUR_PICKSHOT_API_KEY"
}
}
}
}VS Code
프로젝트의 .vscode/mcp.json에 추가하세요:
{
"servers": {
"pickshot": {
"type": "http",
"url": "https://pickshot.ai/mcp",
"headers": {
"Authorization": "Bearer YOUR_PICKSHOT_API_KEY"
}
}
}
}Claude Desktop (브리지 사용)
Claude Desktop처럼 설정 파일에서 내 컴퓨터의 프로그램만 실행할 수 있는 앱은 헤더를 붙여 주는 브리지가 필요해요. 이 예시는 Pickshot이 만들지 않은 오픈소스 mcp-remote 패키지를 써요:
{
"mcpServers": {
"pickshot": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://pickshot.ai/mcp",
"--header",
"Authorization:${PICKSHOT_AUTH}"
],
"env": {
"PICKSHOT_AUTH": "Bearer YOUR_PICKSHOT_API_KEY"
}
}
}
}그 밖의 클라이언트
서버 주소와, Bearer라는 단어와 공백과 내 키로 이루어진 Authorization 헤더를 넣어 주세요. 로그인(OAuth) 연결만 되는 클라이언트는 위의 로그인 연결을 쓰면 돼요.
연결 확인
터미널에서 실행하면 도구 목록이 돌아와야 해요:
curl https://pickshot.ai/mcp \
-H "Authorization: Bearer $PICKSHOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'로그인(OAuth)으로 연결하기
API 키를 보낼 수 없고 로그인 연결만 되는 어시스턴트도 있어요. Pickshot은 그 방식도 지원해요. 브라우저에서 Pickshot에 로그인하고 허용을 누르면 앱이 짧게 유지되는 토큰을 받아요. 앱은 API 키와 같은 범위로 내 계정으로 움직이며, 크레딧 가격, 한도, 안전 규칙이 같고 그 이상은 할 수 없어요.
- 앱에 위의 서버 주소를 넣고 로그인(OAuth) 방식을 고르세요. 앱이 스스로 Pickshot에 등록해요.
- 브라우저에 앱 이름과 돌아가는 주소가 적힌 Pickshot 화면이 열려요. 둘 다 확인하세요. 이름은 앱이 스스로 정한 거예요.
- 허용을 누르거나, 거부를 눌러 거절하세요. 허용하기 전에는 아무것도 연결되지 않아요.
- 끝내려면 API 페이지의 ‘연결된 앱’에서 연결을 끊으세요. 바로 멈춰요.
ChatGPT
ChatGPT에서는 개발자 모드로 Pickshot을 사용자 지정 커넥터(앱)로 추가하고 서버 주소를 넣은 뒤 OAuth를 고르세요. ChatGPT가 스스로 등록하고 허용하러 Pickshot으로 안내해요. 메뉴 이름은 바뀔 수 있으니 ChatGPT 도움말도 확인하세요.
Claude
Claude(claude.ai, Claude Desktop, 모바일 앱)에서는 서버 주소로 사용자 지정 커넥터를 추가하고, 선택 항목인 OAuth 클라이언트 ID와 비밀번호는 비워 두세요. Claude가 스스로 등록하고 허용하러 Pickshot으로 안내해요.
Claude Code
Claude Code에서는 헤더 없이 서버를 추가한 뒤, Claude Code 안에서 /mcp를 실행하고 브라우저의 안내를 따르세요:
claude mcp add --transport http pickshot https://pickshot.ai/mcpMCP 인증 규격(PKCE S256을 쓰는 OAuth 2.1, 동적 클라이언트 등록, resource 매개변수)을 따르는 다른 MCP 클라이언트도 같은 방식으로 연결할 수 있어요. Pickshot이 모든 클라이언트를 시험한 것은 아니니, 연결되지 않으면 API 키를 쓰세요.
도구
어시스턴트에게 보이는 도구예요. 읽기만 하는 도구는 크레딧이 들지 않아요. 무언가 만드는 도구에는 가격 상한과 고정 키가 필요해요.
get_balance | 보유 크레딧과 안전 설정. |
|---|---|
confirm_adult | 호환을 위해 남겨 둔 도구예요. 2026년 11월 12일부터 모든 계정이 2단계라 확인할 것이 없어요(not_available로 답해요). |
list_models | 내 계정에 열린 모델과 방식, 한도, 가격. |
estimate_cost | 요청의 정확한 가격. 절대 차감하지 않아요. |
create_image | 정한 상한 안에서 그림이나 편집을 만들어요. |
create_video | 영상을 만들고 작업을 돌려줘요. |
create_audio | 음성, 음악, 효과음을 만들고 작업을 돌려줘요. |
get_job | 내가 시작한 작업의 상태와 결과. |
list_apps | 사진 앱과 입력 항목, 가격. |
run_app | 링크한 그림으로 사진 앱을 상한 안에서 돌려요. |
list_characters | 저장한 캐릭터와 참고 그림. |
create_character | 그림으로 캐릭터를 저장해요. 본인의 동의가 있을 때만 해요. |
delete_character | 저장한 캐릭터 하나를 지워요. |
get_usage | 이 키와 계정이 실제로 쓴 양. |
쓰는 돈은 내가 정해요
- 만들 때마다 크레딧이 들어요. 사이트에서 무료인 모델도 마찬가지예요. 키로는 무료 체험이 없어요.
- 유료 호출에는 max_credits가 필요해요. 어시스턴트가 먼저 가격을 묻고, 가격이 더 높으면 아무것도 차감하기 전에 거절돼요.
- 유료 호출마다 고정 키가 붙어서, 시간 초과 뒤에 다시 보내도 두 번 차감하지 않고 첫 결과를 돌려줘요.
- 앱마다 키를 따로 만들고, API 페이지에서 언제든 폐기하세요. 로그인으로 연결한 앱은 ‘연결된 앱’에서 같은 방식으로 끊어요. 사용량 탭에서 각 키가 한 일을 볼 수 있어요.
아직 못 하는 것
- 로그인 연결: 앱은 동적 클라이언트 등록으로 등록하고(Client ID Metadata Document는 아직 지원하지 않아요), 돌아가는 주소는 https이거나 localhost여야 하며, 30일 동안 쓰지 않은 연결은 끝나요. 한 사람이 한 번에 연결해 둘 수 있는 앱은 최대 3개예요. 다른 앱을 연결하려면 API 페이지의 ‘연결된 앱’에서 하나를 끊어 주세요.
- 결과물은 내 계정에만 보여요. 공유는 직접 하세요.
자주 묻는 질문
MCP는 따로 돈이 드나요?
추가 요금은 없어요. 읽기만 하는 도구는 무료이고, 무언가 만들면 API 가격만큼 크레딧이 들어요.
어떤 어시스턴트에서 되나요?
API 키를 쓸 때는 HTTP로 원격 서버를 지원하고 요청 헤더를 정할 수 있는 MCP 클라이언트면 돼요. 위 설정은 Claude Code, Cursor, VS Code, 브리지를 쓴 Claude Desktop을 다뤄요. 로그인으로는 ChatGPT와 Claude(Claude Code 포함)가 되는데, 이들의 커넥터는 동적 클라이언트 등록을 쓰는 OAuth 방식이고 Pickshot이 그것을 제공해요. MCP 인증 규격을 따르는 다른 클라이언트도 될 수 있지만 Pickshot이 모두 시험하지는 않았어요.
어시스턴트가 묻지 않고 돈을 쓸 수 있나요?
어시스턴트가 스스로 정한 max_credits만큼만 쓸 수 있어요. 그래서 예산을 먼저 알려 주세요. 실제로 한도를 정하는 것은 계정의 크레딧과 언제든 폐기할 수 있는 키예요. 스킬을 쓰면 어시스턴트가 쓰기 전에 꼭 물어봐요.
만든 것은 어디서 보나요?
그림은 라이브러리에 API로 만든 것으로 표시돼요. API 페이지의 사용량 탭에서 모든 호출과 실행을 셀 수 있어요.