---
sidebar:
  order: 4
title: MCP
description: AI 클라이언트를 Influence 계정, 미디어, 검토, 예약 및 제공되는 인사이트에 연결하세요.
---

작업에 맞는 엔드포인트를 선택하세요. 제품 도구에는 승인된 Influence 워크스페이스가 필요하며 문서 서버는 공개 가이드만 읽습니다.

| 엔드포인트 | 용도 |
| --- | --- |
| `https://influence.so/api/mcp` | 활성화된 계획, 이미지 및 조사 도구를 포함하는 일반 제품 연결입니다. |
| `https://influence.so/api/mcp/claude` | Claude 연결입니다. 미디어 업로드, 초안, 검토, 예약, 계획 및 인사이트를 포함하며 이미지 생성 도구와 `search`/`fetch`는 제외합니다. |
| `https://docs.influence.so/mcp` | 공개 문서를 검색하고 읽습니다. 제품 계정은 필요하지 않으며 워크스페이스 데이터에 접근하거나 게시할 수 없습니다. |

## 연결 및 도구 검색 [#connect-and-discover]

클라이언트의 Influence OAuth 절차를 사용하거나, 클라이언트가 Bearer 인증을 지원한다면 권한 범위가 지정된 API 키를 사용하세요. [앱 및 자동화](https://influence.so/sign-in?next=%2Fapp%2Fsettings%2Faccount%23settings-developer)에서 클라이언트별 설정을 안내합니다. API 키는 클라이언트의 비밀 환경에 보관하세요.

`profileGet`으로 Influence 이메일과 워크스페이스(`nickname`)를 확인한 다음 `connectionStatusGet`으로 권한 범위 및 AI 예약 허용량을 확인하세요. AI 클라이언트 자체 로그인에는 다른 이메일을 사용할 수 있습니다. 권한을 승인할 때 원하는 Influence 계정을 선택하세요.

OAuth 갱신에는 `offline_access`에 대한 명시적 동의가 필요합니다. 새 ChatGPT 사용자 지정 연결의 설정 안내에도 해당 기본 권한 범위가 명시되어 있습니다. 도구 목록을 새로고침해도 권한이 추가되거나 기존 연결의 기본 범위가 확장되지는 않습니다.

`tools/list`와 [MCP 도구 참조](/ko/developers/mcp-tools)를 사용하세요. 검색 결과에 아직 권한을 받지 않은 도구가 나올 수 있지만 호출할 때마다 권한이 적용됩니다. 활성화된 기능과 클라이언트 지원 여부에 따라 가용성이 달라집니다. 일반 엔드포인트와 Claude 엔드포인트는 다릅니다. 스킬이나 플러그인을 다운로드했다고 설치된 클라이언트가 도구를 불러왔다고 볼 수는 없습니다.

## 완성된 콘텐츠 준비 [#prepare-finished-content]

1. `accountList`를 읽은 뒤 선택한 계정마다 `integrationSchema`에서 필수 설정과 미디어 제한을 확인하세요. 보드, 채널 등 대상에는 제공업체별로 지정된 조회 도구를 사용하세요.
2. 접근 가능한 HTTPS 파일은 `mediaImport`에 `url`과 선택적 `name`을 넣어 가져오세요. 실제 호스트 파일은 별도의 `file` 객체를 사용하며 파일 ID를 지어내지 마세요. 로컬 파일에는 멀티파트 업로드 도구 또는 기존 SDK/CLI 도우미를 사용하세요. [미디어 제한 및 준비 상태](/ko/help/media)가 적용됩니다.
3. 완성된 예약 게시물 1–10개에는 항목마다 고정된 `itemKey`, `draft`, `scheduledFor`를 지정해 `campaignScheduleBatchReview`를 사용하세요. 대상별 문구·미디어와 함께 초안 및 대기 중인 검토를 저장하며 전달은 최대 50건입니다. 초안만 준비하거나 수정할 때는 `campaignDraftSave`를 사용하세요. `campaignReview`는 저장된 캠페인에서 의도한 작업을 준비합니다.
4. 저장된 전체 검토를 보여 주세요. 표시되고 로드된 카드가 있으면 해당 카드가 내용을 제시합니다. 카드가 없으면 정확한 계정, 문구, 미디어 미리보기 또는 링크, 설정, 예약 시각 및 시간대를 보여 주세요. 검토가 없거나 오래되었거나 불확실하면 `campaignReviewGet`을 읽으세요.
5. 실행 전에 사람의 새로운 명시적 승인을 받으세요. 지원되는 카드에는 자체 승인 버튼이 있습니다. 요건에 맞는 소셜 게시물의 채팅 승인은 `campaignReviewExecute` 또는 `campaignScheduleBatchExecute`로 제출합니다. 모델은 비공개 `campaignReviewApprove` UI 작업을 호출해서는 안 됩니다.

TikTok Direct는 일반 채팅을 지원합니다. `tiktokCreatorInfoGet`을 읽은 뒤 공개 범위, 상호작용, 홍보 및 해당되는 AI·음악 선택 중 미정인 내용을 질문 1개로 묶어 확인하세요. 적용되는 동의 문구와 링크를 보여 주고 동의를 추정하거나 제한된 상호작용을 활성화하지 마세요. `reviewId`와 함께 `connectionId` 및 `settings`를 담은 `tiktokSettings` 항목을 지정해 `campaignReview`로 사용자의 전체 선택을 저장하세요. 이 응답은 승인이 아니라 새 대기 중인 검토입니다. 정확히 그 검토를 제시하고 새로운 명시적 승인을 기다린 뒤 실행하세요. 지원되는 검토 카드는 선택 사항입니다. TikTok 받은 편지함 게시는 TikTok에서 마칩니다.

TikTok 동의는 정확히 해당 검토에 적용됩니다. 초안에 저장된 동의만으로 이 단계가 완료되지는 않습니다. 검토의 선택을 저장하면 새 초안 버전이 생기고 설정이 같더라도 이전 검토는 오래된 상태가 됩니다.

## 확인 및 복구 [#confirmation-and-recovery]

확인이 필요하다고 표시된 도구는 먼저 `_confirmationCapability`와 `_idempotencyKey` 없이 준비합니다. 반환된 확인 권한 값 및 호출자가 생성해 유지하는 멱등성 키로 동일한 업무 입력을 확인하세요. 이 교환은 도구에 명시된 작업을 저장하거나 실행하며 사람의 게시 승인과는 별개입니다. 호스트의 권한 요청을 따르세요.

`mediaUploadPart`, `mediaUploadComplete`, `mediaUploadAbort`는 승인된 업로드를 직접 이어 갑니다. 파일 바이트는 도구 JSON이 아니라 반환된 저장소 URL로 전송하세요. 중단되면 업로드 상태를 읽고 같은 파일과 `clientKey`로 재개하세요.

업로드의 `expiresAt`은 현재 전송 또는 처리 기한입니다. 처음에는 24시간이며 완료 후 처리가 시작되면 15분입니다. 준비 완료된 미디어는 이 기한으로 만료되지 않습니다. 미디어 라이브러리의 `assetId`를 재사용하세요.

결과가 불확실해도 확인 및 재시도 값을 유지하세요. 게시 작업을 다시 시도하기 전에 저장된 검토 또는 캠페인을 읽고, 시간 초과를 아무 일도 일어나지 않았다는 뜻으로 가정하지 마세요. 검토가 바뀌었거나 만료되었다면 새 검토와 승인이 필요합니다.

[AI 예약 제한](/ko/help/ai-assistants#scheduling-allowance)은 MCP 클라이언트와 Influence IQ 전체에 적용됩니다. 일반 HTTP/CLI 자동화 및 웹에서의 수동 예약은 제외됩니다. 인사이트의 제공 범위와 새로고침 동작은 [인사이트](/ko/help/insights)에서 설명합니다. 선택적인 이벤트 구독에는 별도로 활성화된 호스트의 지원이 필요하며 모든 클라이언트의 백그라운드 알림을 보장하는 기능은 아닙니다.