---
title: "노코드 워크플로 핸드오프"
description: "Twexapi MCP 에이전트 결과를 n8n, Zapier, Make, Pipedream으로 전달합니다."
---

대부분의 노코드 플랫폼은 MCP 세션 자체를 실행할 필요가 없습니다. 신뢰할 수 있는 패턴은 MCP 지원 에이전트가 데이터를 수집한 다음 구조화된 JSON을 워크플로에 전달하는 것입니다.

## 전제조건

- Twexapi API 키
- `https://api.twexapi.io/mcp`에 연결된 MCP 지원 에이전트 또는 프레임워크
- n8n, Zapier, Make, Pipedream 또는 내부 워크플로 실행기의 웹훅 URL
- Sheets, Airtable, Notion, Slack, CRM 또는 데이터베이스 같은 대상 시스템

## 권장 흐름

1. **MCP 지원 에이전트로 수집**

    Claude Code, Cursor, Codex CLI, LangChain, Pydantic AI 또는 `https://api.twexapi.io/mcp`에 연결된 다른 MCP 클라이언트를 사용합니다.

2. **엄격한 JSON 반환**

    ID, 커서, 경로 이름, 행이 포함된 안정적인 스키마를 에이전트에 요청합니다.

3. **노코드 도구로 전송**

    JSON을 n8n, Zapier, Make, Pipedream 또는 내부 워크플로 실행기의 웹훅에 POST합니다.

4. **필요 시 REST로 계속**

    예약 또는 대용량 작업은 `Authorization: Bearer YOUR_API_KEY`로 Twexapi REST를 직접 호출할 수 있습니다.

## 복사-붙여넣기 에이전트 프롬프트

```txt
Use Twexapi MCP to search recent X/Twitter posts about "AI agents".
Call explore first, then twexapi_request.
Return only valid JSON with:
{
  "route_used": "...",
  "query": "AI agents",
  "has_more": true,
  "next_cursor": "...",
  "tweets": [
    {
      "tweet_id": "...",
      "author_username": "...",
      "created_at": "...",
      "text": "...",
      "like_count": 0,
      "reply_count": 0,
      "retweet_count": 0
    }
  ]
}
Do not call write endpoints.
```

## 워크플로 매핑

| JSON 필드 | 일반적인 대상 |
| --- | --- |
| `tweet_id` | 데이터베이스 기본 키, 중복 제거 키, CRM 메모 참조 |
| `author_username` | CRM 계정 필드, Slack 메시지 레이블 |
| `created_at` | 정렬 키 및 보고 타임스탬프 |
| `next_cursor` | 다음 예약 실행을 위한 워크플로 상태 |
| `route_used` | 감사 로그 및 디버깅 필드 |

## 결과 핸드오프

워크플로 페이로드를 작고 안정적으로 유지하세요. 별도로 보관하지 않는 한 Slack 메시지, CRM 메모, 스프레드시트 행에 전체 원시 응답을 전달하지 마세요.

| 행 유형 | 필수 필드 |
| --- | --- |
| 트윗 검색 | `tweet_id`, `text`, `author_username`, `created_at`, `public_url`, `route_used` |
| 프로필 조회 | `user_id`, `username`, `name`, `description`, `followers_count`, `verified` |
| 트렌드 행 | `name`, `rank`, `query`, 요청된 `country`, 요청된 `topic` |
| 페이지네이션 | `has_more`, `next_cursor`, 원본 쿼리 또는 소스 ID |
| 쓰기 계획 | `action`, `endpoint`, `preview`, `requires_human_confirmation` |

## 레시피: 에이전트 연구 → 웹훅

1. AI 에이전트를 Twexapi MCP에 연결합니다.
2. 위 프롬프트를 사용해 엄격한 JSON을 요청합니다.
3. JSON을 워크플로 웹훅에 POST합니다.
4. 워크플로 도구의 반복자 또는 루프 단계로 `tweets`를 순회합니다.
5. `tweet_id`로 행을 upsert합니다.

## 레시피: 예약 연속 실행

일일 작업의 경우 첫 실행은 에이전트 지원으로 하고 이후 실행은 결정적으로 만듭니다.

1. `route_used`, 요청 매개변수, `next_cursor`를 저장합니다.
2. `Authorization: Bearer YOUR_API_KEY`로 Twexapi REST 예약 호출을 실행합니다.
3. `has_more`가 false이거나 워크플로가 행 제한에 도달하면 중지합니다.
4. 선택한 엔드포인트 또는 쿼리를 변경해야 할 때만 예외를 에이전트에 다시 보냅니다.

## 테스트 체크리스트

- 웹훅이 Markdown이 아닌 유효한 JSON을 수신하는지 확인합니다.
- `tweet_id` 또는 `user_id`가 중복 제거에 사용되는지 확인합니다.
- `next_cursor`가 채팅 기록 외부에 영속 저장되는지 확인합니다.
- 쓰기 작업이 사람이 승인할 때까지 계획으로만 표현되는지 확인합니다.
- API 키, 쿠키, auth 토큰이 사용자에게 보이는 대상으로 전송되지 않는지 확인합니다.