@paragraph-com/mcp

Paragraph용 MCP(Model Context Protocol) 서버 — Claude Desktop, Cursor, VS Code Copilot 및 모든 MCP 호환 클라이언트에서 AI 에이전트에 퍼블리케이션을 노출하세요.

원격 서버 (권장)

mcp.paragraph.com에서 호스팅 서버를 사용하세요 — 설치나 API 키 관리가 필요 없습니다. 브라우저에서 Paragraph 계정으로 인증하면 됩니다.

Claude Code

claude mcp add paragraph --transport http https://mcp.paragraph.com/mcp

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

Cursor

.cursor/mcp.json에 추가:

{
  "mcpServers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

VS Code

.vscode/mcp.json에 추가:

{
  "servers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

Related MCP server: thegraph-mcp

로컬 서버

서버를 로컬에서 실행하려면 npx를 사용할 수 있습니다. Node.js 18+가 필요합니다.

npx @paragraph-com/mcp

인증 (로컬 전용)

원격 서버는 인증을 자동으로 처리합니다. 로컬 사용 시 환경 변수로 API 키를 설정하세요:

PARAGRAPH_API_KEY=your-key npx @paragraph-com/mcp

또는 Paragraph CLI로 로그인하세요 — MCP 서버가 동일한 구성을 공유합니다:

npx @paragraph-com/cli login
npx @paragraph-com/mcp

클라이언트별 로컬 설정

claude mcp add paragraph -- npx @paragraph-com/mcp

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "paragraph": {
      "command": "npx",
      "args": ["@paragraph-com/mcp"],
      "env": {
        "PARAGRAPH_API_KEY": "your-key"
      }
    }
  }
}

.cursor/mcp.json 또는 .vscode/mcp.json에 추가:

{
  "servers": {
    "paragraph": {
      "command": "npx",
      "args": ["@paragraph-com/mcp"],
      "env": {
        "PARAGRAPH_API_KEY": "your-key"
      }
    }
  }
}

Streamable HTTP (로컬)

npx @paragraph-com/mcp --http --port 3100

HTTP 모드는 127.0.0.1(localhost 전용)에 바인딩되며 POST 요청을 수락합니다. 상태 확인은 GET /health에서 가능합니다.

사용 가능한 도구

게시물

• get-post — ID 또는 slug로 게시물 가져오기

• list-posts — 퍼블리케이션의 게시물 또는 내 게시물 목록 가져오기

• create-post — 새 게시물 작성 (마크다운)

• update-post — 기존 게시물 수정

• delete-post — 게시물 삭제

• send-test-email — 초안에 대한 테스트 뉴스레터 보내기

콘텐츠

초안 작성용 숏폼 콘텐츠 — X 게시물 및 스레드, LinkedIn 게시물, 일회성 이메일, X Articles. 이 도구들은 초안만 작성하며, 작성자는 Paragraph 앱에서 콘텐츠를 발송합니다.

• create-content — 콘텐츠를 내 퍼블리케이션의 라이브러리에 저장

• list-content — 내 라이브러리 목록 가져오기, 종류와 상태로 필터링 가능

• get-content — 콘텐츠 하나를 본문과 함께 가져오기

• update-content — 콘텐츠 이름 변경 또는 본문 교체

• archive-content — 콘텐츠를 삭제하지 않고 보관

• restore-content — 보관된 콘텐츠 복원

퍼블리케이션

• get-publication — ID, slug 또는 도메인으로 퍼블리케이션 메타데이터 가져오기

구독자

• list-subscribers — 내 구독자 목록 가져오기

• get-subscriber-count — 구독자 수 가져오기

• add-subscriber — 이메일 또는 지갑으로 구독자 추가

사용자

• get-user — ID 또는 지갑으로 사용자 프로필 가져오기

코인

• get-coin — 코인 메타데이터 가져오기 또는 인기 코인 목록

• list-coin-holders — 코인 보유자 목록 가져오기

검색

• search-posts — 게시물 검색

• search-blogs — 퍼블리케이션 검색

• search-coins — 코인 검색

피드

• get-feed — 큐레이션된 플랫폼 피드 가져오기

내 정보

• get-me — 인증된 내 퍼블리케이션 정보 가져오기

애널리틱스

• analytics-query — 내 퍼블리케이션의 애널리틱스에 대해 읽기 전용 SQL 쿼리 실행 (오픈율, CTR, 구독자 수, 인기 게시물 등)

• analytics-schema — 애널리틱스 스키마에서 사용 가능한 테이블과 컬럼 목록

툴셋 필터링

에이전트에 필요한 도구만 노출하세요:

npx @paragraph-com/mcp --toolsets posts,search

사용 가능한 툴셋: posts, content, publications, subscribers, users, coins, search, feed, me, analytics, emails

예시

주제별 게시물 검색 및 요약

프롬프트: "온체인 거버넌스에 관한 게시물을 검색하고 상위 결과 요약을 제공해 줘"

MCP 서버는 쿼리로 search-posts를 호출합니다. Claude는 일치하는 게시물을 받아 주요 주제, 작성자, 퍼블리케이션에 대한 요약을 종합합니다.

블로그 게시물 초안 작성 및 게시

프롬프트: "새로운 토큰 게이팅 기능에 관한 'Weekly Update #12'라는 제목의 게시물을 작성한 다음 게시해 줘"

서버는 제목과 생성된 마크다운 콘텐츠로 create-post를 호출하여 초안을 만듭니다. 사용자가 확인하면 update-post를 호출하여 상태를 published로 설정하고 퍼블리케이션에 게시합니다.

구독자 애널리틱스 확인

프롬프트: "내 퍼블리케이션의 구독자는 몇 명인가요? 가장 최근 구독자들을 보여줘."

서버는 get-me를 호출하여 퍼블리케이션을 식별한 다음, get-subscriber-count로 총 구독자 수를, list-subscribers로 최신 구독자와 세부 정보를 가져옵니다.

뉴스레터 성과에 대한 질문에 답변

프롬프트: "지난 30일 동안의 평균 오픈율은 얼마이고, 어떤 게시물이 가장 성과가 좋았나요?"

서버는 post_analytics_summary에 대해 범위가 제한된 SQL 쿼리로 analytics-query를 호출하여 각 게시물의 오픈율, CTR, 조회수를 반환합니다. Claude는 추세를 요약하고 상위 성과 게시물을 강조합니다.

플랫폼 피드 탐색

프롬프트: "지금 Paragraph에서 트렌딩 중인 것은 무엇인가요?"

서버는 get-feed를 호출하여 큐레이션된 플랫폼 피드를 가져오고, Claude는 상위 게시물, 작성자, 주제를 요약합니다.

게시물 수명 주기 관리

프롬프트: "내 초안을 보여주고 가장 최근 초안에 대한 테스트 이메일을 보내줘"

서버는 status: draft로 list-posts를 호출하여 초안을 가져온 다음, 가장 최근 초안의 ID로 send-test-email을 호출하여 구독자에게 보내기 전에 받은 편지함에서 뉴스레터를 미리 볼 수 있게 합니다.

지원

• 이슈 및 버그: GitHub Issues

• 이메일: support@paragraph.com

• 웹사이트: paragraph.com

릴리스

npm run release patch   # 1.0.0 → 1.0.1
npm run release minor   # 1.0.0 → 1.1.0
npm run release major   # 1.0.0 → 2.0.0

빌드, 테스트, npm 게시, mcp.paragraph.com의 Cloudflare Worker 배포, GitHub 릴리스 생성을 수행합니다. 스크립트는 누락된 자격 증명이 있으면 입력을 요청합니다.

개인정보 처리방침

이 MCP 서버는 사용자를 대신하여 Paragraph API에 연결합니다. 데이터 수집, 사용, 저장 및 사용자 권한에 대한 자세한 내용은 Paragraph 개인정보 처리방침을 참조하세요.

라이선스

MIT