GitHub AI Projects Community — One CLI: 에이전트용 외부 서비스 연결·워크플로 도구

원문: GitHub AI Projects Community 🇯🇵의 X 게시물 · 게시일: 2026-08-15

게시물은 withoneai/cli를 “AI 에이전트에 어떤 앱이든 연결하는 CLI”로 소개한다. Gmail·Slack·Stripe·Notion 연결, OAuth/API key 처리, 액션 검색·실행, 멀티서비스 workflow와 MCP 설정을 핵심 장점으로 내세운다.

핵심 요지

One CLI의 본질: 에이전트가 서비스별 SDK·OAuth·요청 포맷을 각각 학습하는 대신, list → actions search → actions knowledge → actions execute라는 공통 흐름으로 외부 플랫폼 API를 다루게 하는 실행면이다.
MCP와 workflow의 결합: one init은 에이전트 설정에 MCP 서버를 설치하고, one flow는 여러 플랫폼 액션을 조건·반복·병렬·서브플로로 묶는다. X 게시물의 “MCP를 빠르게 정리한다”는 평가는 이 구조와 맞닿아 있다.
핵심 주의점: 오픈소스 CLI 자체가 각 서비스의 OAuth·API gateway를 로컬에서 모두 구현하는 것은 아니다. 코드 기준으로 요청은 api.withone.ai의 /v1/passthrough를 통과하고 One secret·connection key·action ID를 사용한다.
적합한 사용자: 빠르게 Gmail/Slack/Stripe/Notion을 에이전트에 붙이거나, 서비스 간 자동화 프로토타입을 만들거나, MCP 설정을 수작업으로 반복하고 싶지 않은 팀.

수집 범위

기준: @trendtech33566의 X 게시물
범위: 공개 UI에서 도달한 동일 작성자 연속 게시물 2개(기준 게시물 1개 + 후속 답글 1개), X 링크 카드의 공개 GitHub 저장소와 고정 커밋의 README·package manifest·API client·telemetry·workflow 코드를 추가 확인
상태: complete — 수집 시점 공개 UI에서 이 연결 게시물 뒤에 더 이어지는 동일 작성자 게시물은 보이지 않았다.
제한: X 로그인 없이 조사했기 때문에 숨겨진 답글·삭제/비공개 게시물은 확인하지 않았고, 실제 One 인증·외부 API 호출·MCP 설치·flow 실행도 하지 않았다.

스레드 전개

기준 게시물 — withoneai/cli가 Gmail·Slack·Stripe·Notion 등 외부 서비스를 연결하고, 액션 검색·실행과 멀티서비스 workflow를 제공한다고 소개한다.
후속 게시물 — 계정이 AI 관련 GitHub 저장소를 매일 소개한다는 안내와 팔로우 요청을 덧붙인다.

One CLI 구조

AI 에이전트
    ↓ MCP / CLI
One CLI
    ↓ api.withone.ai/v1/passthrough
Gmail · Slack · Shopify · HubSpot · Stripe · ...

저장소 README는 600+ 플랫폼을 주장하며, 실제 코드의 기본 API base는 https://api.withone.ai/v1다. src/lib/api.ts는 연결 목록과 액션 메타데이터를 One API에서 가져오고, 실행 시 x-one-secret, x-one-connection-key, x-one-action-id를 붙여 passthrough endpoint로 보낸다. 즉 이 도구의 편리함은 서비스별 인증·스키마를 One의 중앙 연결 계층으로 추상화하는 데서 나온다.

주요 명령과 사용 흐름

단계	명령	역할
설치·초기화	`npx @withone/cli@latest init`	API key/브라우저 인증, MCP·에이전트 설정 설치
연결	`one add gmail`	플랫폼 OAuth 연결 추가
확인	`one list`	연결 상태·connection key·접근 정책 확인
탐색	`one actions search gmail "send email"`	자연어로 사용 가능한 액션 검색
지식	`one actions knowledge gmail <actionId>`	필수 필드·스키마·플랫폼 주의점 확인
실행	`one actions execute gmail <actionId> <connectionKey>`	실제 API 호출
자동화	`one flow create/validate/execute`	여러 액션을 조건·반복·병렬 workflow로 구성
동기화	`one sync run stripe`	플랫폼 데이터를 unified memory에 적재·검색
webhook	`one relay`	webhook을 다른 연결의 passthrough action으로 전달

README와 agent skill은 액션 실행 전에 반드시 knowledge 단계를 거치도록 안내한다. 이 순서는 에이전트가 액션 ID와 필수 매개변수를 추측해 잘못된 요청을 보내는 위험을 줄이는 설계다.

안전성·운영 메모

자격증명 경계: 에이전트는 raw OAuth token 대신 connection key를 사용한다고 README는 설명하지만, 연결·실행은 One API와 One 계정에 의존한다. 사내 데이터와 권한을 연결하기 전에 One의 보존·처리·감사 정책을 별도로 확인해야 한다.
권한 경계: CLI는 admin/write/read와 connection/action allowlist를 지원한다. read 연결에는 GET만 허용하는 식으로 범위를 줄일 수 있다.
Bash 단계: flow에 Bash가 포함되면 --allow-bash를 명시해야 한다. 이 게이트는 유용하지만, 허용한 flow 파일과 실행 환경 자체를 신뢰해야 한다.
Telemetry: 코드상 사용량 telemetry는 기본 활성화되어 명령 경로·버전·환경·인증 여부 등을 집계한다. 인자·payload·secret은 보내지 않는다고 적혀 있으며 ONE_NO_TELEMETRY=1, DO_NOT_TRACK=1, CI=1, telemetry: off 등으로 끌 수 있다.
공급망: README의 @latest 설치는 편리하지만 재현 가능한 운영 배포에는 버전 고정·lockfile·패키지 무결성 검토가 필요하다.

해석과 적용 메모

MCP 서버를 직접 여러 개 관리하는 대신 중앙 gateway를 쓰는 선택지다. 연결 수가 많고 서비스별 인증 차이가 큰 팀에서는 onboarding 시간을 줄일 수 있다.
대가도 중앙 집중이다. 로컬-first MCP와 달리 One API, 계정, 연결 key, passthrough 정책이 전체 실행 경로의 핵심 의존성이 된다. 장애·비용·데이터 경계를 검증한 뒤 업무 자동화에 투입하는 편이 안전하다.
search → knowledge → execute는 에이전트 도구 사용의 좋은 인터페이스다. 검색 결과를 바로 실행시키지 않고, 별도 지식 조회를 안전장치로 둔 점은 mcp 기반 도구 설계에도 재사용할 수 있다.
실전 도입 순서: read-only 연결과 --dry-run flow로 시작하고, action allowlist·환경별 One config·telemetry opt-out을 먼저 정한 뒤 쓰기 권한과 Bash 단계를 단계적으로 연다.

description	One CLI는 OAuth·API key와 MCP를 한 CLI로 묶어 AI 에이전트가 600+ 외부 플랫폼의 액션과 다단계 워크플로를 실행하게 한다.
tags	ai-agents, dev-tools, typescript, cli, open-source

LLM Wiki

탐색기