본문으로 이동

문서

OpenConnector 클라이언트: SDK, CLI, HTTP 및 MCP

TypeScript SDK, oo CLI, HTTP 또는 MCP로 runtime을 호출하세요. 공개 Hacker News Action부터 시작할 수 있습니다.

유지 관리: OOMOL·

소스 확인일: 2026-09-09. 예제는 링크된 소스 리비전과 대조했습니다. 실제 외부 API 검증을 의미하지 않으며, 배포된 버전과 다를 수 있습니다.

OpenConnector를 사용하는 경우

AI 에이전트가 승인된 계정으로 외부 서비스를 호출해야 하거나 자체 인프라에서 자격 증명과 실행 정책을 관리하려는 경우 OpenConnector를 사용하세요.

시작 방법

자체 호스팅 또는 OOMOL 호스팅 런타임을 선택하고 계정을 연결하세요. Action을 찾고 입력 스키마와 권한을 확인한 다음, 작은 읽기 전용 호출을 실행하고 결과를 확인하세요.

런타임과 API의 범위

이 도메인은 프로젝트 정보와 문서를 제공하며, 호출 가능한 커넥터 API나 MCP 서버를 운영하지 않습니다. 선택한 런타임으로 요청을 보내세요. 자체 호스팅에서는 해당 런타임의 /openapi.json과 /docs를 확인하세요. 자사 사용자의 계정 연결을 제공하는 SaaS 제품은 별도의 OOMOL 제품 통합 가이드를 따라야 합니다.

제품 통합 가이드 ↗

공식 oo CLI 설치

공식 설치 가이드에 따라 oo를 설치한 뒤 oo connector로 Action을 찾고 호출하세요. 선택한 배포 환경에 맞게 런타임 URL, 런타임 토큰, 계정 연결을 설정하세요.

공식 oo CLI 설치 ↗

공식 TypeScript SDK

npm에서 @oomol-lab/connector를 설치하세요. 자체 런타임에는 OpenConnector 클라이언트를 사용하고, 호스팅된 개인 계정이나 SaaS 최종 사용자 계정 연결에는 OOMOL SDK 가이드를 따르세요.

npm
npm install @oomol-lab/connector
npm: @oomol-lab/connector ↗

런타임 OpenAPI 참조 명세

고정된 런타임 리비전에서 생성한 참조 명세를 다운로드하세요. 사용하기 전에 runtimeUrl을 자신의 배포 주소로 설정하세요. 서비스별 Action 스키마는 해당 런타임의 카탈로그에서 가져옵니다. 이 웹사이트는 API 호출을 실행하지 않습니다.

런타임 OpenAPI 참조 명세 →런타임 소스· 72de05b ↗

TypeScript

먼저 @oomol-lab/connector를 설치하세요. 이 예제는 Node.js에서 실행 중인 로컬 OpenConnector 인스턴스를 호출합니다.

TypeScript
import { OpenConnector } from "@oomol-lab/connector";

const connector = new OpenConnector({
  baseUrl: "http://localhost:3000",
  runtimeToken: process.env.OOMOL_CONNECT_RUNTIME_TOKEN,
});

const stories = await connector.hackernews.get_top_stories({});
console.log(stories);

CLI

oo CLI를 설치한 뒤 connector 명령이 로컬 런타임을 사용하도록 설정하세요. 인증을 활성화한 배포에는 런타임 토큰도 필요합니다.

CLI
oo connector login http://localhost:3000
oo connector search "Hacker News"
oo connector schema hackernews.get_top_stories
oo connector run hackernews --action get_top_stories --data '{}'

HTTP

로컬 런타임에서 제공업체 인증이 필요 없는 이 읽기 전용 Action을 실행하세요. 런타임 인증을 활성화했다면 Bearer 토큰을 추가하세요.

HTTP
curl -s -X POST \
  http://localhost:3000/v1/actions/hackernews.get_top_stories \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

MCP

호환되는 에이전트 호스트에 이 HTTP MCP 엔드포인트를 설정하세요. 클라이언트 인증과 지원 도구는 런타임 API 가이드를 참고하세요.

MCP
http://localhost:3000/mcp

결과 읽기

HTTP 런타임 응답에는 success, message, data, meta가 포함됩니다. HTTP 상태만 보지 말고 success와 Action 출력 스키마를 확인하세요. 실행 메타데이터에 executionId가 있으면 해당 식별자로 민감 정보가 가려진 로그를 찾을 수 있습니다. 아래는 응답 구조 예시이며 실제 API 실행 결과가 아닙니다.

응답 구조 예시
{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

호출 실패 시 확인 사항

  • 인증 실패 시 엔드포인트와 자격 증명 유형을 확인하세요. 관리자 자격 증명은 /api를 보호하고 런타임 Bearer 토큰은 /v1과 /mcp에 사용됩니다. 공급자 API 키는 런타임 토큰을 대체하지 못합니다.
  • 권한 거부 시 Action의 필수 scopes, 런타임 Action 규칙과 연결 권한을 확인하세요. 유효한 토큰이라도 선택한 계정에 접근하지 못할 수 있습니다.
  • 결과가 비어 있거나 리소스가 없다면 연결 계정과 해당 리소스 접근 권한을 확인하세요. 인증 성공이 모든 워크스페이스, 채널, 문서의 접근을 보장하지는 않습니다.
  • 재시도 전에 오류와 실행 로그를 확인하세요. 공급자 데이터를 변경하는 Action은 이미 완료되었는지 확인하고 무조건 반복 요청하지 마세요.
Markdown으로 읽기