hystruct-automation

Rube MCP를 통한 Hystruct 자동화

Composio의 Hystruct 툴킷을 Rube MCP를 통해 Hystruct 작업을 자동화합니다.

툴킷 문서: composio.dev/toolkits/hystruct

전제 조건

• Rube MCP가 연결되어 있어야 함 (RUBE_SEARCH_TOOLS 사용 가능)
• RUBE_MANAGE_CONNECTIONS를 통해 hystruct 툴킷으로 활성 Hystruct 연결 필요
• 항상 먼저 RUBE_SEARCH_TOOLS를 호출하여 현재 도구 스키마를 확인하세요

설정

Rube MCP 가져오기: 클라이언트 설정에서 MCP 서버로 https://rube.app/mcp를 추가하세요. API 키가 필요 없습니다. 엔드포인트만 추가하면 작동합니다.

1. RUBE_SEARCH_TOOLS가 응답하는지 확인하여 Rube MCP가 준비되었는지 확인합니다
2. RUBE_MANAGE_CONNECTIONS를 hystruct 툴킷으로 호출합니다
3. 연결 상태가 ACTIVE가 아니면, 반환된 인증 링크를 따라 설정을 완료합니다
4. 워크플로를 실행하기 전에 연결 상태가 ACTIVE인지 확인합니다

도구 검색

워크플로를 실행하기 전에 항상 사용 가능한 도구를 검색하세요:

RUBE_SEARCH_TOOLS
queries: [{use_case: "Hystruct operations", known_fields: ""}]
session: {generate_id: true}

이 명령은 사용 가능한 도구 슬러그, 입력 스키마, 권장 실행 계획 및 알려진 문제점을 반환합니다.

핵심 워크플로 패턴

1단계: 사용 가능한 도구 검색

RUBE_SEARCH_TOOLS
queries: [{use_case: "your specific Hystruct task"}]
session: {id: "existing_session_id"}

2단계: 연결 확인

RUBE_MANAGE_CONNECTIONS
toolkits: ["hystruct"]
session_id: "your_session_id"

3단계: 도구 실행

RUBE_MULTI_EXECUTE_TOOL
tools: [{
  tool_slug: "TOOL_SLUG_FROM_SEARCH",
  arguments: {/* search results에서 얻은 schema-compliant args */}
}]
memory: {}
session_id: "your_session_id"

알려진 문제점

• 항상 먼저 검색: 도구 스키마는 변경될 수 있습니다. RUBE_SEARCH_TOOLS를 호출하지 않고 도구 슬러그나 인수를 하드코딩하지 마세요.
• 연결 확인: 도구를 실행하기 전에 RUBE_MANAGE_CONNECTIONS에서 ACTIVE 상태인지 확인하세요.
• 스키마 준수: 검색 결과의 정확한 필드 이름과 타입을 사용하세요.
• 메모리 파라미터: RUBE_MULTI_EXECUTE_TOOL 호출에 항상 memory를 포함하세요. 비어 있어도 ({}) 괜찮습니다.
• 세션 재사용: 워크플로 내에서 세션 ID를 재사용하세요. 새 워크플로에는 새 ID를 생성하세요.
• 페이지네이션: 응답에서 페이지네이션 토큰을 확인하고 완료될 때까지 계속 가져오세요.

빠른 참조

작업	방법
도구 찾기	RUBE_SEARCH_TOOLS (Hystruct 관련 use case)
연결	RUBE_MANAGE_CONNECTIONS (툴킷 hystruct)
실행	RUBE_MULTI_EXECUTE_TOOL (검색된 도구 슬러그 사용)
대량 작업	RUBE_REMOTE_WORKBENCH (run_composio_tool() 사용)
전체 스키마	RUBE_GET_TOOL_SCHEMAS (schemaRef가 있는 도구용)

---

Composio 제공