> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 도구 사용하기

> 채팅, 게시, 분석, 관리 도구를 선택하고 안전하게 실행합니다.

## 개요

채팅, 게시, 분석, 생성, 관리를 설명합니다. 구체적 목적에는 개별 도구를, 다단계 작업 전체를 맡길 때만 `chat`을 씁니다.

## 호출 방식 선택하기

클라이언트가 요청에 맞게 선택합니다. 개별 도구는 작업이 명확하고 보통 `chat`보다 빠르며 크레딧과 범위를 이해하기 쉽습니다.

| 요청 | 방식 | 예시 |
| - | - | - |
| 하나의 목표 | 개별 도구 | 워크스페이스 목록, 게시물 검색, 이미지 하나 |
| 조사·판단·생성 통합 | `chat` | 브랜드 조사, 기획, 여러 초안 |

“워크스페이스를 확인해 줘”처럼 목표를 말하거나 “`list_workspaces`를 써 줘”라고 지정합니다.

## `chat`에 작업 위임하기

`chat`은 조사, 분석, 작성, 미디어 생성을 에이전트에 위임합니다. 단일 검색·조회는 개별 도구를 우선합니다.

| 파라미터 | 필수 | 설명 |
| - | - | - |
| `deliverable` | 새 대화 필수 | 결과물과 수량, 예를 들어 Instagram 초안 3개. |
| `outputLanguage` | 새 대화 필수 | 출력 언어이며 일본어는 `ja`입니다. |
| `prompt` | 예 | 배경과 추가 지시입니다. |
| `audience` | 아니요 | 독자입니다. |
| `brandContext` | 아니요 | 제품, 가격, 기간 등 맥락입니다. |
| `voice` | 아니요 | 문체와 이모지입니다. |
| `constraints` | 아니요 | 글자 수, CTA, 금지 표현입니다. |
| `workspaceId` | 아니요 | 워크스페이스 ID입니다. |
| `sessionId` | 아니요 | 같은 결과물을 수정하는 대화 ID입니다. |

결과물, 플랫폼, 계정, 독자, 브랜드나 제품, 문체, 언어, 글자 수를 지정하세요.

`pendingQuestions`에 질문이 생기면 작업이 멈춥니다. 답을 넣은 `prompt`과 같은 `sessionId`로 `chat`을 다시 호출합니다.

## 워크스페이스와 연동 조회하기

다음 도구를 씁니다.

* `list_workspaces` — 접근 가능한 ID와 이름 조회.
* `list_integrations` — 연동과 게시 계정 ID 조회.
* `get_connect_url` — NoimosAI의 제공업체 연결 화면 URL 조회.

URL을 열어 OAuth를 마치고 `list_integrations`로 다시 봅니다.

## 초안 저장 및 게시하기

`post`는 NoimosAI 형식으로 저장·게시·예약합니다. 클라이언트 AI가 만든 게시물과 `chat` 결과 모두 받습니다.

| 파라미터 | 형식 | 필수 | 설명 |
| - | - | - | - |
| `posts` | `array` | 예 | 게시물 목록이며 계정 ID는 `list_integrations`에서 얻습니다. |
| `mode` | `string` | 아니요 | `draft`, `publish`, `schedule` 중 선택합니다. `mode`와 기존 `schedule` 매개변수를 모두 생략하면 `draft`로 저장합니다. |
| `scheduleAt` | `string` | 조건부 | `mode: "schedule"`일 때 필수이며 시간대를 넣습니다. |
| `workspaceId` | `string` | 아니요 | 워크스페이스 ID입니다. |
| `dryRun` | `boolean` | 아니요 | `true`는 게시 없이 대상과 형식을 점검합니다. |

`dryRun: true`로 대상을 보고 본문을 검토합니다. 승인 후 `mode: "publish"`나 `mode: "schedule"`를, 대기 중에는 `mode: "draft"`를 씁니다.

> [!WARNING]
>
> `dryRun`는 대상과 형식 점검이며 게시 성공을 보장하지 않습니다.

## 게시물, 기사, 웹사이트 관리하기

전용 도구를 씁니다.

* `delete_posts` — 초안·예약 취소와 게시물 삭제.
* `publish_article` — WordPress, X Articles, Substack 기사 게시·예약.
* `list_pinterest_boards` — Pinterest 보드 ID 조회.
* `create_website` / `publish_website` — 사이트 생성·게시.

게시물 삭제는 복구 불가입니다. 로컬 코드를 보내는 `upload_website_source`는 Local 전용입니다.

## 브랜드와 지식 관리하기

참조 정보를 관리합니다.

* `get_workspace_context` — 브랜드, 목표, 언어, 계정을 함께 조회.
* `get_workspace_brand` / `update_workspace_brand` — 전체 브랜드 가이드 조회·변경.
* `knowledge_dataset_*` / `knowledge_content_*` — 지식 데이터셋과 콘텐츠 관리.
* `create_workspace_and_onboard` — 워크스페이스 생성 및 AI 조사 온보딩.

`get_workspace_context`는 `chat` 전 맥락을 봅니다. `update_workspace_brand`로 `keywords`, `websites`를 갱신하면 목록 전체가 대체됩니다. 지식 베이스에 콘텐츠를 추가할 때 임베딩 크레딧을 쓰며 워크스페이스 생성은 플랜과 권한 제한을 받습니다.

## DM과 댓글 답장하기

읽기 도구로 ID를 얻고 메시지를 검토합니다.

* `send_dm` — X, Instagram, Facebook, TikTok 기존 DM에 텍스트 전송.
* `reply_to_comment` — X·Instagram 댓글이나 멘션 답장.

초안 없이 즉시 보냅니다. 계정, ID, 본문을 보여주고 명시적 승인을 받으세요.

DM ID는 `get_direct_messages`, 댓글 ID는 `list_x_user_mentions`, `instagram_comments_list`, `instagram_mentioned_comment_get` 등에서 얻습니다.

## 개별 검색·분석·생성 사용하기

연결하면 이전 게시물, 소셜 검색, 트렌드, GA4, Google Search Console, Semrush, 사이트 분석, 조사, 미디어 도구가 로드됩니다.

`[Billed]` 도구는 실제 처리량에 따라 크레딧을 씁니다. 오프라인이나 미인증 상태에서는 카탈로그 없이 기본 도구만 보일 수 있습니다.

## 이미지와 영상 생성하기

모델과 비용을 검토하고 생성한 뒤 이력에서 상태와 파일을 얻습니다.

| 단계 | 주요 도구 | 용도 |
| - | - | - |
| 모델 선택 | `list_media_models`, `get_media_model_form` | 모델, 입력, 기능 조회 |
| 비용 조회 | `get_media_model_cost` | 생성 전 크레딧 견적 |
| 생성 및 편집 | `generate_image`, `generate_video`, `edit_image`, `edit_video` | 미디어 생성·수정 |
| 상태와 파일 조회 | `get_creation`, `list_creations`, `get_media_url`, `download_creation` | 처리 추적 및 파일 확보 |
| 입력 준비 | `upload_media` | Local에서 허용 파일 업로드 |

모델을 나열한 뒤 정사각 이미지 하나의 견적과 입력을 요청합니다. 모델, 입력, 비용 검토 후에만 생성하세요.

`upload_media`는 파일을 NoimosAI로 보냅니다. 파일과 목적을 검토하고 업로드를 명시적으로 승인한 뒤 실행하세요.

## 영향 있는 작업 검토하기

AI가 제안해도 사람이 대상과 내용을 먼저 검토합니다.

* 게시물, 기사, 사이트 게시 및 예약
* DM과 댓글 전송
* 공개 게시물 삭제
* 브랜드와 지식 변경·삭제
* 로컬 파일 업로드
* 크레딧 소비 도구

클라이언트 확인 화면이 있어도 NoimosAI 대상, 워크스페이스, 계정 ID를 봅니다.

## 관련 페이지

설정과 다른 접속 방법은 다음 페이지에 있습니다.

* [연결하기](https://docs.noimosai.com/ko/developers/mcp/setup.md)
* [기본 이해하기](https://docs.noimosai.com/ko/developers/cli/overview.md)
* [npm 패키지](https://www.npmjs.com/package/@noimosai/mcp)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.