MCP 서버

LinkedIn MCP 서버 모든 AI 에이전트가 LinkedIn에 게시하게 하세요

AI 에이전트가 프롬프트 하나로 LinkedIn의 개인 프로필이나 내가 관리하는 회사 페이지에 텍스트 게시물, PDF 문서, 이미지, 동영상을 게시하게 하세요. LinkedIn 공식 API로 작동합니다.

mcp.json
{
  "mcpServers": {
    "upload-post": {
      "url": "https://mcp.upload-post.com/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

에이전트가 호출할 수 있는 LinkedIn 도구

Upload-Post MCP 서버의 일부입니다. 에이전트가 프롬프트에 맞는 도구를 골라 씁니다.

도구 기능
upload_text 프로필 또는 회사 페이지에 텍스트 게시물 게시, 링크 미리보기 선택 가능
upload_document PDF, PPT(X), DOC(X) 문서 게시물 게시. LinkedIn "캐러셀"이 바로 이 형식입니다
upload_photos / upload_video 이미지 및 동영상 게시물 게시
get_linkedin_pages 관리 중인 회사 페이지와 그 ID 목록 조회
list_scheduled / edit_scheduled / cancel_scheduled 예약된 게시물 관리
get_analytics 회사 페이지 팔로워, 노출 수, 참여도 가져오기

직접 API를 찾고 계신가요? LinkedIn API 페이지를 참고하세요.

LinkedIn MCP 서버를 Claude나 Cursor에 추가하기

mcp.upload-post.com/mcp에 호스팅된 서버 하나로 끝납니다. 클라이언트가 지원하는 방식에 맞춰 OAuth로 로그인하거나 Upload-Post API 키를 붙여 넣으세요.

Claude Desktop

Settings > Developer > Edit Config에서 파일을 열고 항목을 붙여 넣은 뒤 Claude Desktop을 다시 시작하세요. 내 컴퓨터에서 오픈소스 npm 패키지 @upload-post/mcp를 실행하며, Node.js 18 이상이 필요합니다.

파일 없이 하고 싶나요? claude.ai나 Claude Desktop에서는 Claude 디렉터리(claude.ai/directory/upload-post, 또는 Customize > Connectors에서 Upload-Post 검색)에서 공식 Upload-Post 커넥터를 추가하고 Connect를 클릭한 뒤 Upload-Post 계정으로 로그인(OAuth)하세요.

claude_desktop_config.json
{
  "mcpServers": {
    "upload-post": {
      "command": "npx",
      "args": ["-y", "@upload-post/mcp"],
      "env": { "UPLOAD_POST_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Claude Code

OAuth가 편하다면 --header 줄을 빼고, Claude Code 안에서 /mcp를 실행해 로그인하세요. 모든 프로젝트에서 서버를 쓰려면 --scope user를 추가합니다.

Terminal
claude mcp add --transport http upload-post https://mcp.upload-post.com/mcp \
  --header "Authorization: ApiKey YOUR_API_KEY"

Cursor

프로젝트 하나에만 쓰려면 .cursor/mcp.json에, 모든 프로젝트에 쓰려면 ~/.cursor/mcp.json에 넣고 Cursor를 다시 불러오세요.

.cursor/mcp.json
{
  "mcpServers": {
    "upload-post": {
      "url": "https://mcp.upload-post.com/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

API 키는 app.upload-post.com의 API Keys 메뉴에 있습니다. 첫 게시 전에 대시보드에서 LinkedIn 계정을 프로필에 연결하세요. 에이전트는 그 프로필 이름을 user 값으로 넘깁니다. ChatGPT에서는 Apps에서 Upload-Post를 검색해 Connect를 누르면 되고, 설정 파일은 필요 없습니다.

예시: 회사 페이지에 PDF 문서 게시물 올리기

이름, ID, URL은 예시용이며 실제 고객 대화가 아닙니다. 도구 이름과 파라미터는 서버가 실제로 제공하는 그대로입니다.

사용자

https://example.com/q3-report.pdf 에 있는 3분기 리포트를 Acme Analytics 회사 페이지(Upload-Post 프로필 "acme")에 올려 줘. 제목은 "3분기 제품 리포트", 두 줄짜리 소개를 쓰고 전체 공개로 해 줘.

  1. 도구 호출 1

    get_linkedin_pages

    에이전트가 페이지 ID를 추측하지 않고 직접 조회합니다.

    arguments
    {
      "profile": "acme"
    }
    result (일부 생략)
    {
      "success": true,
      "pages": [
        {
          "id": "urn:li:organization:12345678",
          "name": "Acme Analytics",
          "vanityName": "acme-analytics"
        }
      ]
    }
  2. 도구 호출 2

    upload_document

    문서 게시물(흔히 PDF 캐러셀이라고 부르는 것)은 전용 도구가 있습니다. 페이지 ID가 게시물을 회사 페이지로 보냅니다.

    arguments
    {
      "documentPathOrUrl": "https://example.com/q3-report.pdf",
      "user": "acme",
      "title": "3분기 제품 리포트",
      "description": "슬라이드 12장으로 보는 3분기: 출시한 것, 달라진 것, 다음에 할 것.",
      "targetLinkedinPageId": "urn:li:organization:12345678",
      "linkedinVisibility": "PUBLIC"
    }
    result (일부 생략)
    {
      "success": true,
      "results": {
        "linkedin": {
          "success": true,
          "post_id": "urn:li:activity:7654321098765432",
          "url": "https://www.linkedin.com/feed/update/urn:li:activity:7654321098765432/",
          "content_type": "document"
        }
      }
    }

어시스턴트

완료했습니다. "3분기 제품 리포트"가 Acme Analytics 페이지에 전체 공개 문서 게시물로 올라갔습니다: https://www.linkedin.com/feed/update/urn:li:activity:7654321098765432/

  • targetLinkedinPageId를 빼면 같은 호출이 연결된 LinkedIn 계정의 개인 프로필에 게시합니다.
  • 파일은 공개 URL로 접근할 수 있어야 합니다. 호스팅된 MCP 서버는 내 컴퓨터의 파일을 읽을 수 없으니, PDF를 먼저 어딘가에 올리거나 대시보드에서 게시하세요.
  • 이 호출들에 scheduledDate와 timezone을 더하면 지금 게시하는 대신 예약할 수 있습니다.

같은 에이전트로 올리는 다른 LinkedIn 게시물

upload_photos: 개인 프로필에 올리는 이미지 게시물, 1촌에게만 공개.

{
  "photosPathsOrUrls": [
    "https://example.com/team-offsite.jpg"
  ],
  "user": "acme",
  "platforms": [
    "linkedin"
  ],
  "title": "팀 워크숍 후에 바꾼 세 가지. 두 번째는 저도 의외였습니다.",
  "platformOptions": {
    "linkedinVisibility": "CONNECTIONS"
  }
}

upload_text: 링크 미리보기가 붙는 텍스트 게시물, 마드리드 시간 월요일 9시 예약.

{
  "title": "온보딩을 처음부터 다시 만들었습니다. 무엇을, 왜 바꿨는지 정리했습니다.",
  "user": "acme",
  "platforms": [
    "linkedin"
  ],
  "linkUrl": "https://example.com/blog/onboarding",
  "scheduledDate": "2026-10-05T09:00:00",
  "timezone": "Europe/Madrid"
}

공식 LinkedIn API. 스크래핑도, 비밀번호 공유도 없습니다

LinkedIn MCP 서버가 실제로 내 계정에 접근하는 방식.

MCP 서버는 내 계정으로 로그인하거나, LinkedIn을 스크래핑하거나, 브라우저를 조작하지 않습니다. AI 클라이언트가 서버를 호출하고, 서버가 Upload-Post를 호출하고, Upload-Post가 승인받은 자체 LinkedIn 앱으로 LinkedIn REST API를 통해 게시합니다. LinkedIn 연결은 LinkedIn의 권한 화면에서 한 번만 하므로, LinkedIn 비밀번호는 Upload-Post에도 AI 클라이언트에도 전달되지 않습니다.

LinkedIn이 승인을 요청하는 권한은 외부 게시 도구에 쓰이는 표준 권한입니다. 본인으로 게시하는 w_member_social과 회사 페이지로 게시하는 w_organization_social입니다. LinkedIn은 페이지에 관리자 역할(administrator 또는 content admin)이 있어야 그 페이지로 게시할 수 있게 하며, 이 규칙은 여기서도 똑같이 적용됩니다.

LinkedIn 사용자 약관은 허가되지 않은 자동화 방식으로 게시물을 만들거나 공유하는 것, 스크래핑 도구와 브라우저 플러그인, 로그인 정보 공유를 금지합니다. 자동화 계정이 제한을 받는 이유는 대개 이런 것들입니다. 공식 API 위의 승인된 앱은 LinkedIn이 이런 도구를 위해 마련한 경로입니다. 그렇다고 스팸과 콘텐츠에 관한 LinkedIn 규칙에서 면제되는 것은 아니니, 사람이 책임질 수 있는 게시물을 쓰세요.

LinkedIn 액세스 토큰은 약 60일간 유효하며 꾸준히 쓰면 갱신됩니다. Upload-Post 프로필에서 언제든 LinkedIn 연결을 해제할 수 있고, OAuth로 로그인한 AI 클라이언트는 대시보드의 Connected Apps에서 권한을 취소할 수 있습니다.

출처: LinkedIn Posts API, LinkedIn 사용자 약관 8.2항, Upload-Post LinkedIn 가이드, GitHub의 upload-post-mcp.

에이전트가 지키는 LinkedIn 한도

LinkedIn과 Upload-Post가 게시물 하나에 허용하는 범위, 2026년 9월 확인.

항목 한도 출처
게시물 본문 3,000자 Upload-Post 글자 수 제한
문서 또는 동영상 제목 400자(이모지는 2자로 계산). 더 긴 제목은 말줄임표로 잘립니다. Upload-Post 문서 업로드
문서 PDF, PPT, PPTX, DOC, DOCX, 최대 100MB, 300페이지 LinkedIn Documents API
동영상 3초~30분, 75KB~500MB LinkedIn Videos API
이미지 JPEG, PNG, GIF, 최대 36,152,320픽셀. 움직이는 GIF는 최대 250프레임 Upload-Post 사진 요건
공개 범위 PUBLIC(기본값), CONNECTIONS, LOGGED_IN, CONTAINER Upload-Post LinkedIn 가이드
페이지로 게시 해당 페이지에 administrator 또는 content admin 역할이 필요 LinkedIn Posts API

모든 MCP 클라이언트와 호환

같은 서버, 같은 도구입니다. AI 클라이언트를 선택하고 3단계 가이드를 따라 하세요.

이 LinkedIn 프롬프트들을 시도해 보세요

외울 명령어는 없습니다. 원하는 것을 설명하세요.

“v2 출시를 알리는 LinkedIn 게시물을 작성해 게시하세요. 과장 없이 담백하게요.”
“이 PDF를 우리 회사 페이지에 문서 캐러셀로 게시하세요.”
“다음 주 월요일 마드리드 시간 10:00에 LinkedIn 텍스트 게시물을 예약해 주세요.”
“이번 달 우리 회사 페이지 성과는 어땠나요? 팔로워, 노출 수, 참여도를 알려 주세요.”

자주 묻는 질문

LinkedIn + AI 에이전트에 관한 모든 것. 최종 업데이트: 2026년 9월.

LinkedIn MCP 서버란 무엇인가요?

LinkedIn MCP 서버는 LinkedIn 게시 기능을 AI 에이전트가 호출할 수 있는 도구로 노출하는 Model Context Protocol 서버입니다. Upload-Post MCP 서버를 사용하면 ChatGPT, Claude, Gemini 또는 모든 MCP 클라이언트가 별도의 코드 없이 LinkedIn에 텍스트, 문서, 이미지, 동영상을 게시할 수 있습니다.

AI 에이전트가 LinkedIn 회사 페이지에 게시할 수 있나요?

네. get_linkedin_pages 도구가 관리 중인 회사 페이지를 나열하고, 에이전트가 게시물마다 그중 어느 페이지든, 또는 개인 프로필을 대상으로 지정할 수 있습니다.

PDF 캐러셀도 게시할 수 있나요?

네. upload_document 도구가 PDF, PPT, PPTX, DOC, DOCX 파일을 LinkedIn 문서 게시물로 올리며, LinkedIn은 이를 넘겨 보는 캐러셀로 보여 줍니다. 제목은 필수이고 최대 400자입니다.

LinkedIn MCP 서버는 무료인가요?

MCP 서버는 MIT 라이선스의 무료 오픈 소스입니다. 월 10회 업로드가 되는 Free 플랜을 포함해 모든 Upload-Post 플랜에서 작동합니다.

LinkedIn MCP 서버를 Claude에 어떻게 추가하나요?

Claude Code에서는 claude mcp add --transport http upload-post https://mcp.upload-post.com/mcp 를 실행하고 /mcp로 로그인하거나, --header로 API 키를 넘기세요. claude.ai나 Claude Desktop에서는 Claude 디렉터리(claude.ai/directory/upload-post)에서 공식 Upload-Post 커넥터를 추가하고 Connect를 클릭한 뒤 OAuth로 로그인합니다. Claude Desktop에서 로컬로 실행하려면 API 키가 들어간 npx @upload-post/mcp 항목을 claude_desktop_config.json에 추가하세요. 그다음 Upload-Post 대시보드에서 LinkedIn을 프로필에 연결하세요.

개인 프로필에 올라가나요, 회사 페이지에 올라가나요?

둘 다 됩니다. 페이지 ID가 없으면 연결된 LinkedIn 계정의 개인 프로필에 게시됩니다. targetLinkedinPageId에 get_linkedin_pages로 얻은 ID를 넣으면 그 회사 페이지 이름으로 게시됩니다. LinkedIn은 페이지에 administrator 또는 content admin 역할을 요구합니다.

이걸 쓰면 LinkedIn이 계정을 제한할 수 있나요?

서버는 승인된 앱과 LinkedIn 자체 권한 화면을 거쳐 LinkedIn 공식 API를 씁니다. LinkedIn 사용자 약관이 금지하는 비밀번호 공유, 스크래핑, 브라우저 자동화는 하지 않습니다. 콘텐츠와 스팸에 관한 LinkedIn 규칙은 여전히 지켜야 합니다.

LinkedIn 게시물 한도는 어떻게 되나요?

게시물 본문은 최대 3,000자, 문서나 동영상 제목은 400자입니다. 문서는 PDF, PPT, PPTX, DOC, DOCX로 최대 100MB, 300페이지입니다. 동영상은 3초~30분, 75KB~500MB입니다.

에이전트가 LinkedIn 분석 데이터를 읽을 수 있나요?

내가 관리하는 회사 페이지라면 가능합니다. get_analytics에 페이지 URN을 넘기면 그 페이지의 수치를 돌려줍니다. 개인 프로필은 지원하지 않습니다. LinkedIn이 회원 게시물 읽기 권한(r_member_social)을 승인된 개발자에게만 주기 때문입니다.

LinkedIn 스크래퍼인가요?

아닙니다. 내 게시물과 페이지를 게시하고 관리할 뿐입니다. 프로필을 스크래핑하거나, 사람을 검색하거나, 1촌 신청을 보내지 않습니다.

AI 에이전트에게 LinkedIn 운영을 맡기세요

무료로 시작, 신용카드 불필요. LinkedIn 계정을 한 번 연결하면 어떤 MCP 클라이언트에서든 게시할 수 있습니다.