ScriptIt

에이전트 도구를 위한 단일 컨트롤 플레인. 원격 MCP 서버를 한 번 연결하면, 모든 에이전트 — 어떤 샌드박스에서든 — 두 가지 방식으로 다시 사용할 수 있습니다:

• 원격 MCP 엔드포인트(/mcp) — 간결한 메타 도구 포함(도구 목록 비대화 없음), 그리고

• CLI(scriptit) — 에이전트가 공개 키 핸드셰이크를 통해 샌드박스 내부에서 페어링할 수 있으며, MCP 도구 호출을 통해 승인됩니다. 업스트림 자격 증명은 샌드박스에 들어가지 않습니다.

또한 스크립팅을 위한 프록시 LLM 엔드포인트와 워치(watch) 기능: 명령이나 도구를 주기적으로 실행하고, 선택적으로 LLM이 출력을 검증하며, 에이전트가 폴링하거나 스트리밍할 수 있는 구조화된 이벤트를 생성합니다.

로컬 우선 빌드: 모든 것이 사용자 머신에서 실행됩니다(SQLite, 단일 서버 프로세스).

빠른 시작

pnpm install
pnpm build
pnpm start            # control plane on http://127.0.0.1:4747 (prints admin + mcp tokens)

개발 모드(서버 + 웹 UI + 데모 업스트림 MCP, 모두 감시):

pnpm dev

• 대시보드: http://127.0.0.1:4747 (개발 UI: http://127.0.0.1:5173) — 관리자 토큰으로 로그인.

• 데모 업스트림 MCP 서버: http://127.0.0.1:4748/mcp (echo, get_time, list_cronjobs).

• LLM 기능은 서버 환경에 ANTHROPIC_API_KEY(또는 ant auth login 프로필)가 필요합니다.

Related MCP server: cloud-to-local

에이전트 연결 (MCP)

Claude Code(또는 모든 MCP 클라이언트)에 추가:

claude mcp add --transport http scriptit http://127.0.0.1:4747/mcp --header "Authorization: Bearer <mcp token>"

도구: list_connectors, search_tools, call_tool, approve_cli, create_watch, list_watches, run_watch, delete_watch, get_events, llm.

CLI 페어링 (핸드셰이크)

샌드박스 / 모든 셸에서:

scriptit pair                 # prints a code like AB3D-9XKQ and waits

그런 다음 에이전트에게 ScriptIt MCP 연결을 통해 해당 코드로 approve_cli를 호출하도록 요청하거나, 대시보드에서 승인합니다. 이후부터:

scriptit connectors
scriptit call demo list_cronjobs
scriptit llm "summarize:" - < notes.txt
scriptit watch create --name failed-crons \
  --connector demo --tool list_cronjobs --interval 5m \
  --verify "Emit an event iff any cronjob is failing; type=cron_failure, summarize which."
scriptit events --follow --json      # structured events, one JSON per line

CLI는 모든 요청에 ed25519 키로 서명합니다. 세션은 수명이 짧고 대시보드에서 취소할 수 있습니다. 업스트림 토큰은 컨트롤 플레인에만 존재하며, 저장 시 암호화됩니다.

레이아웃

참고 사항

• 로컬 빌드는 localhost를 신뢰합니다: admin/mcp 토큰이 인증 경계입니다. 4747을 노출하지 마세요.

• OAuth 커넥터는 Dynamic Client Registration + PKCE를 사용합니다(Linear, Notion, Sentry, Atlassian, Stripe, Supabase 등과 호환). Bearer/PAT 커넥터는 GitHub의 MCP 및 유사 서비스를 지원합니다.

• scriptit watch 명령형 워치는 서버 호스트에서 셸 명령을 실행합니다 — 이것이 의도된 동작입니다(로컬 빌드). 하지만 공유 환경에 배포할 때는 이 점을 기억하세요.