MCP 서버에이전트

FoPost MCP 서버

npm 패키지 하나로 FoPost 워크스페이스가 MCP 도구 세트가 돼요. 로컬 MCP 서버를 지원하는 클라이언트라면 게시물 예약, 전송 확인, 콘텐츠 재활용을 할 수 있고, 모든 단계에서 승인을 거쳐요.

mcpServers
{
  "mcpServers": {
    "fopost": {
      "command": "npx",
      "args": ["-y", "@fopost/mcp"],
      "env": { "FOPOST_API_KEY": "your-api-key" }
    }
  }
}

표준 MCP

stdio 전송 방식, 자체 프로토콜 없음. 클라이언트가 MCP 서버를 지원한다면 바로 맞아요.

14가지 도구

게시물, 전송, 계정, 워크스페이스, 그리고 세 가지 AI 도우미.

범위가 지정된 API 키

워크스페이스당 키 하나, 허용한 범위로만 제한돼요.

설치

이미 쓰는 클라이언트에 추가하기

대시보드에서 API 키를 만들고, 클라이언트 설정에 mcpServers 블록을 붙여 넣은 뒤 재시작하세요. 서버는 stdio로 로컬에서 실행되고, 입력한 키로만 API와 통신해요.

클라이언트별 설정 보기
터미널
# Runs with no install step
FOPOST_API_KEY=your-api-key npx -y @fopost/mcp

npx로 실행

전역 설치가 필요 없어요. 첫 실행 때 패키지를 받아 캐시해요.

설정 블록 하나

같은 JSON이 Claude Desktop, Cursor, Windsurf 등에서 작동해요.

키는 로컬에

키는 클라이언트 설정에 저장되고 API로만 전송돼요.

도구

대시보드에서 게시물로 할 수 있는 모든 것

도구 세트는 게시물의 전체 수명 주기를 다뤄요. 예약, 수정, 취소, 삭제, 목록 보기에 네트워크별 전송 상태까지요. 계정 및 워크스페이스 도구로 클라이언트가 게시하기 전에 어디에 게시할 수 있는지 먼저 파악해요.

도구 둘러보기
도구
list_posts        get_post           schedule_post
edit_post         cancel_post        delete_post
list_post_deliveries               list_accounts
get_account_health                 list_workspaces
generate_caption  rewrite_for_platforms
repurpose_url     get_ai_credits

게시물 수명 주기

어떤 클라이언트에서든 게시물을 만들고, 변경하고, 취소하고, 삭제해요.

전송 상태

어떤 네트워크가 게시물을 받았고 어디가 받지 못했는지 확인해요.

AI 도우미

캡션, 네트워크별 다시 쓰기, URL 재활용에는 AI 크레딧이 사용돼요.

안전

먼저 묻는 에이전트를 위해

서버는 스스로 게시하지 않아요. 클라이언트가 보낸 도구 호출 안에서만 동작하고, 대부분의 클라이언트는 실행 전에 그 호출을 보여 줘요. API 키의 범위가 도구가 접근할 수 있는 곳을 제한해요.

API 키 받기
게시 캘린더에 예약된 한 달 치 게시물

자율 게시 없음

모든 쓰기 작업에는 도구 호출이 필요해요. 읽기는 아무것도 바꾸지 않아요.

워크스페이스 격리

키 하나는 워크스페이스 하나에만 접근해요. 클라이언트 계정이 섞이지 않아요.

언제든 취소

대시보드에서 키를 교체하거나 삭제하면 서버가 즉시 멈춰요.

MCP 서버에 대해 자주 묻는 질문

어떤 클라이언트를 지원하나요?

stdio로 로컬 MCP 서버를 실행하거나 원격 서버에 연결하는 모든 클라이언트를 지원해요. Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Gemini CLI, OpenClaw, ChatGPT 등이 있어요.

원격 또는 호스팅 MCP 엔드포인트가 있나요?

네, https://api.fopost.com/mcp에 있어요. 원격 URL을 지원하는 클라이언트는 여기에 연결해 FoPost에 로그인하면 되고, API 키는 필요 없어요.

비용은 얼마인가요?

패키지는 오픈 소스이고 무료예요. FoPost 플랜을 사용하며, 세 가지 AI 도구만 AI 크레딧을 소모해요.

키에 어떤 범위가 필요한가요?

posts, accounts, workspaces, deliveries 범위로 예약과 확인을 할 수 있어요. 게시까지 하려면 publish를, AI 도구에는 ai를 추가하세요.

분석을 읽을 수 있나요?

현재는 MCP로는 안 돼요. 분석은 대시보드와 analytics 범위를 가진 REST API에서 확인할 수 있어요.

소스는 어디에 있나요?

패키지는 npm에 MIT 라이선스로 @fopost/mcp라는 이름으로 게시되어 있고, 패키지 페이지에 저장소 링크가 있어요.

MCP 서버에서 FoPost 사용하기

무료로 시작할 수 있고 MCP 서버가 포함돼요. 키를 만들고, 서버를 추가하고, 에이전트에서 첫 게시물을 예약하세요.

API 키 받기