---
title: "문서 MCP 서버"
description: "Mintlify가 호스팅하는 MCP 서버를 통해 AI 도구에서 Twexapi 문서를 검색하세요."
---

Twexapi 문서는 `https://docs.twexapi.io/mcp`에서 MCP 서버로 제공됩니다. AI 도구는 대화 중에 전체 문서 사이트를 검색하고 색인이 생성된 공개 페이지를 검색할 수 있습니다. 이는 라이브 Twexapi API 엔드포인트와 상호 작용하는 `https://api.twexapi.io/mcp`의 [Twexapi API MCP 서버](/mcp/overview)와 별개입니다. 문서 검색 도구에는 인증이 필요하지 않으며 실시간 Twexapi API를 호출하지 않습니다.

:::note
  `https://docs.twexapi.io/mcp`는 브라우저 페이지가 아닌 MCP 전송 엔드포인트입니다. 일반적인 `GET` 요청으로 열면 JSON-RPC 메서드 오류가 반환될 수 있습니다. MCP 클라이언트는 동일한 URL에 연결하고 `tools/list`와 같은 MCP 메소드를 호출해야 합니다.
:::

## 문서 MCP 서버

`https://docs.twexapi.io/mcp`에서 문서를 검색하고 색인화된 공개 페이지를 읽어보세요. 인증이 필요하지 않습니다. 무료. 일부 클라이언트는 문서 피드백을 위해 Mintlify의 `submit_feedback` 도구를 표시할 수도 있습니다.

## API MCP 서버

`https://api.twexapi.io/mcp`에서 X/Twitter 데이터와 상호 작용합니다. API 키 또는 OAuth 2.1을 사용하세요. 기본 엔드포인트에 따라 비용 크레딧을 호출합니다.

## 상담원 경로 체크리스트

### 먼저 문서를 읽어보세요

공개 문서, API 매개변수, 예제, 오류 코드, SDK 지침 및 인증되지 않은 페이지 검색을 위해서는 `https://docs.twexapi.io/mcp`에서 Docs MCP를 사용하세요.

### 계정 작업 실행

라이브 X/Twitter 읽기, 쓰기, 검색, 트렌드, 추출, 커뮤니티, 목록, DM, 기사 또는 타임라인 작업을 위해 `https://api.twexapi.io/mcp`에서 API MCP를 사용하세요. API 키 또는 OAuth 2.1로 인증하세요.

### 채팅 외부에서도 지속

백엔드가 재시도, 커서 저장소, 파일 다운로드, 대기열, 예약된 작업 또는 일괄 오케스트레이션을 소유해야 하는 경우 REST 또는 생성된 SDK를 사용하세요.

### 결과 전달

에이전트 실행을 종료하기 전에 엔드포인트 경로, 요청 매개변수, 반환된 ID, 'has_more', 'next_cursor', 내보내기 경로, 청구된 크레딧을 저장하세요.

## 빠른 연결

문서 페이지 상단에 있는 상황별 메뉴를 사용하여 즉시 연결하세요.

- MCP 서버 URL 복사 - `https://docs.twexapi.io/mcp`를 클립보드에 복사합니다.
- MCP 설치 명령 복사 -`npx add-mcp` 설치 명령을 복사합니다.
- 커서에 연결 - 커서에 문서 MCP 서버를 설치합니다.
- VS Code에 연결 - VS Code에 문서 MCP 서버를 설치합니다.

## 설정

### 웹 및 터미널 클라이언트

- [클로드.ai](#claude-ai)
- [클로드코드](#claude-code)
- [코덱스 CLI](#codex-cli)

<a id="claude-ai"></a>

#### 클로드.ai

1. Claude에서 [설정 > 커넥터](https://claude.ai/settings/connectors)로 이동하세요.
2. **맞춤 커넥터 추가**를 선택합니다.
3. 입력하다:
   - 이름:`Twexapi Docs`
   - URL: `https://docs.twexapi.io/mcp`
4. **추가**를 선택합니다.
5. 채팅에서 첨부 파일 버튼을 클릭하고 **Twexapi Docs**를 선택하세요.

<a id="claude-code"></a>

#### 클로드 코드

문서 MCP 서버를 추가합니다:

```bash
claude mcp add --transport http twexapi-docs https://docs.twexapi.io/mcp
```

다음을 통해 확인하세요.

```bash
claude mcp list
```

<a id="codex-cli"></a>

#### 코덱스 CLI

`~/.codex/config.toml`에 추가:

```toml
[mcp_servers.twexapi_docs]
url = "https://docs.twexapi.io/mcp"
```

### 편집자 클라이언트

- [커서](#cursor)
- [VS 코드](#vs-code)
- [윈드서핑](#windsurf)
- [오픈코드](#opencode)

<a id="cursor"></a>

#### 커서

`~/.cursor/mcp.json`(전역) 또는 `.cursor/mcp.json`(프로젝트)에 추가합니다.

```json
{
  "mcpServers": {
    "twexapi-docs": {
      "url": "https://docs.twexapi.io/mcp"
    }
  }
}
```

<a id="vs-code"></a>

#### VS 코드

`.vscode/mcp.json`(프로젝트)에 추가하거나 **MCP: 사용자 구성 열기**(전역)를 사용합니다.

```json
{
  "servers": {
    "twexapi-docs": {
      "type": "http",
      "url": "https://docs.twexapi.io/mcp"
    }
  }
}
```

<a id="windsurf"></a>

#### 윈드서핑

`~/.codeium/windsurf/mcp_config.json`에 추가:

```json
{
  "mcpServers": {
    "twexapi-docs": {
      "serverUrl": "https://docs.twexapi.io/mcp"
    }
  }
}
```

<a id="opencode"></a>

#### 오픈코드

`opencode.json`에 추가:

```json
{
  "mcp": {
    "twexapi-docs": {
      "type": "remote",
      "url": "https://docs.twexapi.io/mcp"
    }
  }
}
```

## 두 MCP 서버 모두 사용

최상의 경험을 위해서는 다음 두 가지를 모두 연결하세요.

1. Docs MCP(`docs.twexapi.io/mcp`) - AI가 문서를 검색하여 API 매개변수, 오류 코드 및 사용 패턴을 이해합니다.
2. API MCP(`api.twexapi.io/mcp`) - AI는 검색, 조회, 추세, 추출 및 쓰기 작업과 같은 인증된 작업을 실행합니다.

AI는 상황에 따라 쿼리할 서버를 결정합니다. 요청 매개변수에 대한 질문은 문서 서버에 문의해야 합니다. 라이브 X/Twitter 데이터를 가져오라는 요청이 API 서버에 도달해야 합니다.

### 클로드 코드

```bash
claude mcp add --transport http twexapi-docs https://docs.twexapi.io/mcp
claude mcp add --transport http twexapi https://api.twexapi.io/mcp --header "x-api-key:twexapi_YOUR_KEY_HERE"
```

### 커서

```json
{
  "mcpServers": {
    "twexapi-docs": {
      "url": "https://docs.twexapi.io/mcp"
    },
    "twexapi": {
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}
```

### VS 코드

```json
{
  "servers": {
    "twexapi-docs": {
      "type": "http",
      "url": "https://docs.twexapi.io/mcp"
    },
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}
```

## 사용 가능한 도구

Mintlify는 사이트 이름에서 문서 도구 이름을 생성합니다. `name`을 `twexapi`로 설정하여 이 문서 구성을 배포한 후 docs MCP 서버는 다음을 노출합니다.

| 도구 | 목적 |
| --- | --- |
| `search_twexapi` | 엔드포인트, 매개변수, 오류 코드, 워크플로 또는 가이드 주제별로 색인화된 Twexapi 문서를 검색합니다. |
| `query_docs_filesystem_twexapi` | 색인화된 문서 파일을 읽고 정확한 페이지 콘텐츠를 검사하세요. |
| `submit_feedback` | 클라이언트에서 지원하는 경우 페이지 수준 문서 피드백을 보냅니다. |

:::tip
  현재 프로덕션 배포는 업데이트된 `docs.json`이 배포될 때까지 계속 `search_twexapi_io` 및 `query_docs_filesystem_twexapi_io`를 반환할 수 있습니다. 배포 후 `tools/list`는 `search_twexapi` 및 `query_docs_filesystem_twexapi`를 반환해야 합니다.
:::

## 검색되는 내용

문서 MCP 서버는 공개 Twexapi 문서를 색인화합니다.

- API 참조 작업 및 요청 스키마
- 인증, 요율 제한, 오류 및 청구 안내
- MCP 서버 설정 및 도구 참조
- LangChain, CrewAI, Pydantic AI, Google ADK, Haystack, Mastra, 코드 없는 도구 및 워크플로 플랫폼을 위한 프레임워크 가이드
- 검색, 프로필, 트렌드, 기사, 커뮤니티, 목록, 타임라인 및 추출에 대한 워크플로 가이드
- `llms.txt` 및 기타 Mintlify에서 생성된 문서 색인

## 예시 프롬프트

```txt
Use Twexapi Docs MCP to find the authentication guide, then explain how to configure the API MCP server with x-api-key.
```

```txt
Search the Twexapi docs for advanced search parameters, then tell me which API MCP call should be used for recent tweets about AI agents.
```

```txt
Find the docs for article Markdown fetches and generate a minimal Python example using the documented request shape.
```