자격 증명, 승인, 전송 상태
범위가 지정된 자격 증명으로 접근 제한
정확한 게시 작업 승인
전송 상태 확인
MCP로 연결된 계정 조회하기
이 Node.js 예시는 Influence에 연결해 워크스페이스의 소셜 계정 목록을 조회합니다. 초안을 만들거나 게시물을 게시하지 않고 계정 정보만 읽습니다.
1. 읽기 권한이 있는 키 만들기
‘설정’에서 앱 및 자동화 → 개발자 도구를 여세요. 연결된 채널 조회 (integrations:read)만 선택하고 나머지 권한은 모두 해제한 뒤 API 키를 만드세요. 키는 로컬 비밀 정보 저장소나 환경 변수에 INFLUENCE_API_TOKEN으로 저장하세요. 키는 1번만 표시됩니다. 소스 파일이나 채팅에 넣지 마세요.
API 키 설정 열기2. 예시 실행하기
Node.js와 npm이 설치된 상태에서 프로젝트에 MCP SDK를 설치하세요. 아래 코드를 accounts.mjs로 저장한 뒤, INFLUENCE_API_TOKEN이 설정된 환경에서 node accounts.mjs를 실행하세요. MCP 연결과 초기화는 SDK가 처리합니다.
npm install @modelcontextprotocol/client@2.3.1accounts.mjs
import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
const token = process.env.INFLUENCE_API_TOKEN;
if (!token) throw new Error("Set INFLUENCE_API_TOKEN first.");
const client = new Client({ name: "influence-quickstart", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(
new URL("https://influence.so/api/mcp"),
{ requestInit: { headers: { Authorization: `Bearer ${token}` } } }
);
try {
await client.connect(transport);
const result = await client.callTool({
name: "accountList",
arguments: { limit: 20 }
});
console.log(JSON.stringify(result.structuredContent, null, 2));
if (result.isError) process.exitCode = 1;
} finally {
await client.close();
}3. 응답 읽기
계정 이름과 ID를 가상으로 구성한 응답 예시입니다. 실제 응답에는 워크스페이스와 연결된 소셜 계정을 식별하는 정보가 담깁니다.
{
"ok": true,
"output": {
"cursor": null,
"done": true,
"items": [
{
"connectionId": "account_example_01",
"eligible": true,
"name": "Example studio",
"platform": "bluesky",
"supportsImage": true,
"supportsText": true,
"supportsVideo": true
}
],
"workspaceId": "workspace_example_01",
"workspaceName": "Example workspace"
},
"toolName": "accountList"
}결과의 의미
계정이 조회된 경우
connectionId로 각 계정을 식별하세요. eligible, supportsText, supportsImage, supportsVideo는 현재 게시 가능 여부와 지원 기능을 나타냅니다. 게시물을 준비하기 전에 각 값을 다시 확인하세요.
조회된 계정이 없는 경우
ok: true, items: [], done: true는 조회가 성공했다는 뜻입니다. workspaceName에 표시된 워크스페이스에서 소셜 계정을 연결한 뒤 예시를 다시 실행하세요.
결과가 여러 페이지인 경우
done이 false이면 반환된 cursor와 동일한 limit으로 accountList를 다시 호출하세요. done이 true가 될 때까지 계속하세요. 첫 페이지에는 계정이 20개보다 적을 수도 있습니다.
접근이 거부된 경우
401 응답이 오면 키가 유효하고 integrations:read 권한이 있는지 확인하세요. API 키는 권한 범위가 빠져도 401을 반환할 수 있습니다. OAuth 연결은 403 insufficient_scope를 반환할 수 있습니다. 다시 연결하고 계정 조회 권한을 승인하세요.
ChatGPT와 Claude는 키 대신 브라우저 인증으로 연결할 수 있습니다. 해당 어시스턴트의 설정 가이드를 따른 뒤 연결된 계정 목록을 요청하세요. 위 예시는 전체 MCP 엔드포인트인 https://influence.so/api/mcp를 사용합니다. Claude core 커넥터에는 별도의 연결 안내가 있습니다.
도구와 필요한 권한 알아보기
GET /api/v1/tools는 API 키로 사용할 수 있는 도구 목록을 반환합니다. 이 예시 요청은 accountList의 권한과 확인 요건을 골라 보여 줍니다. 초안을 만들려면 추가 쓰기 권한이 필요합니다.
HTTP API
GET /api/v1/tools애플리케이션에서 도구 목록을 읽고 사용 가능한 도구를 호출합니다.
MCP
tools/list지원되는 어시스턴트가 도구를 찾아 같은 검토 절차를 따릅니다.
1. 초안 준비하기
워크스페이스의 계정과 미디어로 campaignDraftSave를 호출하세요. 응답이 중단됐을 때 복구할 수 있도록 버전과 요청 식별 정보를 보관하세요. 초안을 저장할 때는 서버의 확인이 필요합니다.
2. 검토 내용 준비하기
저장된 버전과 작업에 대해 campaignReview를 호출하세요. 승인을 요청하기 전에 계정, 콘텐츠, 미디어, 설정, 시각, 만료 시점을 보여 주세요.
3. 승인된 작업 실행하기
campaignReviewExecute를 호출하려면 해당 검토 내용 그대로의 승인이 필요합니다. 텍스트 게시물은 전체 검토 내용을 본 뒤 새 답글로 승인해야 하고, 미디어는 직접 보고 승인해야 합니다. 서버는 제공업체를 직접 호출하는 대신 작업을 영속 스케줄러에 전달합니다.
4. 재시도 전에 결과 확인하기
계정별 상태와 제공되는 게시물 링크를 확인하세요. 전송 결과가 불확실하면 결과가 확인될 때까지 ‘검토 필요’ 상태가 유지됩니다. 새 게시물을 만들기 전에 기존 요청을 복구하세요. 그렇지 않으면 중복 전송될 수 있습니다.
도구에 맞는 연결 방식 선택하기
| 연결 방식 | 용도 | 접근 권한 |
|---|---|---|
| HTTP API | 애플리케이션에서 도구 목록을 읽고 사용 가능한 도구를 호출합니다. | 권한 범위가 지정된 bearer 인증 정보를 환경 변수에 저장해 사용하세요. |
| MCP | 지원되는 어시스턴트가 도구를 찾아 같은 검토 절차를 따릅니다. | Influence ‘설정’에서 해당 어시스턴트의 연결 안내를 따르세요. 사용 가능 여부는 호스트와 부여된 권한에 따라 달라집니다. |
도구 목록 요청
curl --fail-with-body 'https://influence.so/api/v1/tools' \
--header "Authorization: Bearer $INFLUENCE_API_TOKEN" \
| jq '{tools: [.tools[] | select(.name == "accountList") | {name, scopes, confirmation, mutability}]}'도구 목록 필드 예시
{
"tools": [
{
"confirmation": "none",
"mutability": "read",
"name": "accountList",
"scopes": [
"integrations:read"
]
}
]
}이 필드 예시는 도구 정의에서 가져왔습니다. 사용할 수 있는 작업은 현재 도구 목록, 인증 정보의 권한 범위, 연결된 계정에 따라 달라집니다.

직접 구성하는 게시 워크플로
기존 콘텐츠 작업 흐름에서 게시물 만들기
사용하는 도구에서 글, 변경 기록, 커뮤니티 공지를 바탕으로 초안을 준비하세요. Influence에 게시 예약을 요청하기 전에 정확한 계정, 콘텐츠, 시간을 검토할 수 있게 제시하세요.
응답을 받지 못한 요청 복구
원래 요청과 멱등성 키를 보관하고 해당 결과를 조회하세요. 전송 결과가 확실하지 않으면 실제로 무슨 일이 있었는지 확인할 때까지 검토 필요 상태가 유지됩니다. 대체 요청을 새로 만들면 같은 게시물이 2번 게시될 수 있습니다.
Influence IQ로 첫 초안 만들기
글, 프로젝트 메모, 커뮤니티 소식과 저장된 브랜드 가이드라인을 Influence IQ에 제공해 수정 가능한 초안을 만드세요. 이용 가능한 권한이 부여된 AI 도구는 IQ 크레딧을 사용하며 기존 확인 요건이 적용됩니다.
메모와 저장된 브랜드 가이드라인을 Influence IQ에 제공하면 수정 가능한 게시물 초안과 권장 날짜를 받을 수 있습니다. 초안 작성과 이미지 생성에는 IQ 크레딧이 사용됩니다. 이미지 생성을 시작하기 전에 견적을 확인하고, 게시하기 전에 완성된 콘텐츠를 검토하세요.
Influence IQ 알아보기AI 어시스턴트와 시작하세요
지원되는 Influence 연결을 사용하면 ChatGPT 또는 Claude에서 캠페인을 계획하고 초안을 수정할 수 있습니다. 어시스턴트가 접근할 수 있는 이미지와 동영상을 업로드하거나 Influence에 준비된 미디어를 재사용하도록 요청하세요. 파일에 접근할 수 없다면 먼저 Influence에 업로드하세요. 정확한 계정, 텍스트, 미디어, 설정, 시간을 검토한 다음, 지원되는 채팅 내 카드에서 승인하거나 전체 검토 내용을 확인한 뒤 새로 “승인합니다”라고 답하세요. TikTok Direct에서는 채팅으로 게시 옵션을 선택하고 동의한 뒤, 갱신된 검토 내용을 승인하세요. 검토 카드는 선택 사항입니다. 설정에서 초기 설정 방법과 연결 상태를 확인하세요.
연결한 계정에 게시하세요
워크스페이스에서 이용 가능한 계정을 선택하세요. 게시 대상별로 텍스트와 지원 미디어를 수정한 뒤 게시물을 검토하고 게시하세요.
자주 묻는 질문
- API와 MCP 워크플로로 무엇을 할 수 있나요?
- 활성화된 도구와 권한에 따라 API 또는 MCP 클라이언트로 연결 계정, 저장된 초안, 지원 미디어, 게시물 검토, 예약, 전송 상태를 다룰 수 있습니다.
- API나 MCP 호출은 승인을 우회하나요?
- 아니요. 서버가 각 도구의 확인 요건을 적용합니다. 게시에는 현재 검토 내용에 대한 승인이 필요합니다. 실행 시 전송을 예약하기 전에 워크스페이스, 권한, 계정, 콘텐츠를 확인합니다.
- 어시스턴트 워크플로는 어떤 미디어를 지원하나요?
- 어시스턴트가 접근할 수 있는 이미지와 동영상을 업로드하거나 Influence에 준비된 미디어를 재사용하도록 요청하세요. 파일에 접근할 수 없다면 먼저 Influence에 업로드하세요. 정확한 계정, 텍스트, 미디어, 설정, 시간을 검토한 다음, 지원되는 채팅 내 카드에서 승인하거나 전체 검토 내용을 확인한 뒤 새로 “승인합니다”라고 답하세요. TikTok Direct에서는 채팅으로 게시 옵션을 선택하고 동의한 뒤 갱신된 검토 내용을 승인하세요. 검토 카드는 선택 사항입니다.
- 응답 누락이나 불확실한 전송은 어떻게 처리해야 하나요?
- 원래 요청의 결과를 복구하고 기록된 상태를 확인하세요. 결과가 모호한 전송을 반복하지 마세요. 검토 필요 상태는 기록을 대조해 실제 결과를 확인할 때까지 미해결로 유지됩니다.
- MCP 지원이면 모든 어시스턴트 호스트에서 작동하나요?
- 아니요. 로그인한 뒤 설정 → 앱 및 자동화 → AI 도우미 연결에서 설정 안내와 현재 연결 상태를 확인하세요.
- 연동 기능으로 예약되거나 게시된 게시물을 수정할 수 있나요?
- 전송이 시작되지 않았고 미해결 전송이 없다면 예약 게시물을 초안으로 되돌려 수정하고 다시 검토할 수 있습니다. 어시스턴트는 소셜 네트워크에 이미 게시된 콘텐츠를 수정하거나 삭제할 수 없습니다.