MCP Server

PulitzerAI MCP 연동

OAuth 기반 계정 연결을 통해 Cursor, Codex, Claude Desktop, 사내 Agent에서 PulitzerAI 기능을 도구처럼 호출할 수 있습니다.

Transport

Streamable HTTP

POST / GET JSON-RPC 2.0

인증

OAuth 2.0

Authorization Code + Bearer Token

과금

API Credit

기존 API 사용량과 통합

연동 엔드포인트

https://api.pulitzer.ai/live/tools/mcp

Cursor / Codex

원격 MCP 서버 URL을 등록하면 OAuth 승인 화면을 통해 계정을 연결합니다.

Claude Desktop

Streamable HTTP와 OAuth web auth를 지원하는 클라이언트에서 MCP 엔드포인트를 연결합니다.

Internal Agent

OAuth access token을 Authorization Bearer 헤더로 전달해 tools/list와 tools/call을 호출합니다.

OAuth 인증 흐름

PulitzerAI MCP 서버는 OAuth authorization code 흐름을 기본 인증 방식으로 사용합니다. 기존 API Key 방식은 호환 목적으로 계속 허용됩니다.

mcp:tools

MCP 클라이언트가 서버의 OAuth metadata를 조회합니다.

사용자는 PulitzerAI 로그인 후 MCP OAuth Consent 화면에서 권한을 승인합니다.

클라이언트는 authorization code를 access token으로 교환합니다.

Tool 호출 시 OAuth access token을 Authorization Bearer 헤더로 전달합니다.

Authorization Server

https://api.pulitzer.ai/live/tools

Protected Resource

https://api.pulitzer.ai/live/tools/mcp

제공 Tool Catalog

사용량 보기

도메인	Tools	과금 기준
보도자료	generate_press_releasemodify_press_releaseget_press_releaselist_press_releasescreate_press_reference	조회 무과금, AI 생성/수정 프리미엄 과금
기자 데이터	get_reporter_categoriessearch_reporterssearch_reporters_by_media	조회 기준 기본 과금
뉴스 클리핑	list_newsclip_feedssearch_newsclip_articlesquick_search_newsget_newsclip_articlerequest_news_clipping_custom_collectget_news_clipping_custom_collect_status	뉴스 조회 무과금, 커스텀 수집은 페이지 기준 과금
배포/성과	prepare_releasecreate_release_draftget_release_statusget_release_resultanalyze_campaign_performance	준비/조회 중심. 실제 배포 실행은 보류
콘텐츠 생성	generate_blog_postgenerate_sns_contentcreate_adcopycreate_generic_contenttranslate_article	AI 생성 작업 과금
CRM 워크스페이스	list_crm_workspaceslist_workspace_reportersadd_workspace_reporterrecord_reporter_meetingsummarize_workspace_pr_outcomes	조회 무과금, 변경성 작업은 업무 로그 기준 관리
빌링	get_api_credit_balanceget_api_usage_historyget_api_daily_usageget_api_monthly_usageget_api_cost_config	무과금 또는 기본 조회

요청 예시

{
  "jsonrpc": "2.0",
  "id": 10,
  "method": "tools/call",
  "params": {
    "name": "search_reporters",
    "arguments": {
      "category_names": ["경제", "IT"],
      "page": 1,
      "page_size": 10
    }
  }
}

응답 구조

{
  "content": [
    {
      "type": "text",
      "text": "기자 검색이 완료되었습니다."
    }
  ],
  "structuredContent": {
    "summary": "기자 10명을 찾았습니다.",
    "data": [],
    "billing": {
      "charged": true,
      "credit_kind": "API_CREDIT"
    }
  }
}

운영 정책

OAuth access token은 Tool input이 아니라 Authorization Bearer 헤더로 전달합니다.

기존 User API Token과 OpenAPI Access Token은 하위 호환을 위해 Bearer 또는 PULITZER-API-KEY 헤더로 허용합니다.

MCP session id는 인증 정보가 아니며, 사용자 식별은 OAuth token subject 또는 호환 토큰의 사용자 정보로 수행합니다.

크레딧 부족, 권한 부족, 비동기 작업 실패는 JSON-RPC error.data.reason으로 구분합니다.

뉴스 수집처럼 오래 걸리는 작업은 collect_id를 반환하고 상태 조회 Tool로 폴링합니다.

삭제, 결제/충전, 실제 외부 배포 실행, 파일 다운로드처럼 별도 확인이 필요한 작업은 MCP Tool로 제공하지 않습니다.