Superglue CLI: 사전 구축된 도구 없이 AI 에이전트가 API 호출을 실행할 수 있게 합니다

Superglue CLI는 모든 sg 명령어 사용법, 인증 처리, 도구 구축, 실패 디버깅 방법을 AI 에이전트에게 가르치는 구조화된 스킬 레퍼런스를 포함한 명령줄 인터페이스입니다. 핵심 아이디어는 모든 API 통합을 위한 하드코딩된 도구를 구축하는 대신, 에이전트를 어떤 API든 가리키면 런타임에 사양을 읽고 호출을 계획하며 실행할 수 있도록 추론할 수 있다는 것입니다.

설치 및 설정

npm을 통해 CLI를 전역으로 설치하세요:

npm install -g @superglue/cli

대화형 설정 실행:

sg init

이 명령은 API 키(app.superglue.cloud/admin에서 확인 가능), 엔드포인트, 출력 환경설정을 요청합니다. CI나 AI 에이전트와 같은 비대화형 환경에서는 환경 변수를 설정하세요:

export SUPERGLUE_API_KEY="your-api-key"
export SUPERGLUE_API_ENDPOINT="https://api.superglue.cloud"

sg system list로 확인하세요 — 인증 오류가 보이면 API 키와 엔드포인트를 확인하세요.

스킬 설치

이 스킬은 AI 에이전트에게 CLI에 대한 완전한 지식 — 명령어, 인증 패턴, 도구 스키마, 디버깅, 배포 — 을 제공합니다. 한 번 설치하면 에이전트가 자동으로 이를 참조합니다.

모든 에이전트를 위한 범용 설치:

npx skills add superglue-ai/cli

-g -a <agent>로 특정 에이전트를 대상으로 지정:

npx skills add superglue-ai/cli -g -a claude-code
npx skills add superglue-ai/cli -g -a codex
npx skills add superglue-ai/cli -g -a cursor

Claude Code의 경우 Anthropic 마켓플레이스에서 설치:

/plugin install superglue@claude-plugins-official

또는 로컬 설치에서 로드:

claude --plugin-dir $(npm root -g)/@superglue/cli

Cursor의 경우 스킬을 프로젝트 또는 전역 디렉토리에 복사:

cp -r $(npm root -g)/@superglue/cli/skills/superglue .cursor/skills/superglue
# 또는 전역적으로
cp -r $(npm root -g)/@superglue/cli/skills/superglue ~/.cursor/skills/superglue

스킬이 제공하는 것

• 플래그, 옵션, 사용 패턴을 포함한 모든 CLI 명령어
• 인증 패턴 — 자격 증명 자리 표시자, OAuth 흐름, 헤더 형식
• 도구 구성 스키마 — 단계 구성, 데이터 선택자, 변환, 페이지 매김
• 디버깅 워크플로 — 일반적인 오류, --include-step-results, 격리를 위한 sg system call
• 배포 패턴 — SDK, REST API, 웹훅 (참조/integration.md를 통해)
• 데이터베이스, 파일 서버, 변환을 위한 전문 참조 (요청 시 로드)

프로젝트별 컨텍스트 추가

프로젝트의 AI 구성 파일(CLAUDE.md, AGENTS.md, 또는 .cursorrules)에 섹션을 추가하여 에이전트가 스킬을 사용하고 설정을 동적으로 발견하도록 하세요. 다음과 같은 지침을 포함하세요:

## Superglue 사용하기
superglue 도구 작업 시 — CLI, SDK, 또는 REST API를 통해:
1. superglue 스킬을 호출하고 모든 sg 명령어 실행 전에 SKILL.md 파일을 읽으세요
2. 작업에 관련된 참조 파일(통합, 데이터베이스, 파일 서버, 변환)을 읽으세요
3. CLI가 구성되었는지 확인하세요(sg init이 실행되었거나 환경 변수가 설정됨)
4. sg system list와 sg tool list를 실행하여 구축 또는 수정 전 현재 설정을 발견하세요
5. 시스템 ID나 도구 ID를 하드코딩하지 마세요 — 항상 동적으로 발견하세요

모범 사례

도구를 구축하기 전에 항상 시스템을 테스트하세요. 에이전트가 sg system call을 실행하여 인증을 확인하고 도구 구성 구축 전 실제 응답 형태를 보도록 하세요:

sg system call --system-id stripe \
  --url "https://api.stripe.com/v1/customers?limit=2" \
  --headers '{"Authorization":"Bearer <>"}'

디버깅 시 --include-step-results를 사용하여 각 단계의 원시 API 응답을 표시하세요 — 문제가 인증, 엔드포인트, 또는 변환인지 정확히 파악합니다:

sg tool run --draft <id> --payload '{}' --include-step-results

채팅에 비밀을 붙여넣지 마세요. CLI를 통해 시스템을 생성할 때 --sensitive-credentials를 사용하여 비밀이 안전하게 요청되도록 하세요.

이 접근 방식은 팀이 에이전트를 구축하지만 사용자가 "Salesforce에서 이 세 객체를 가져와서 X 조건이 참일 때 nCino에 푸시하세요"와 같은 구체적인 요구사항을 설명하는 "사전 정의된 도구" 한계를 해결합니다. 각 요청을 하드코딩된 도구로 변환하는 대신, 에이전트는 API 사양을 읽고 사용자별 로직으로 다단계 작업을 처리할 수 있습니다.