ScriptIt

Eine zentrale Steuerungsebene für die Tools deines Agents. Verbinde entfernte MCP-Server einmal; jeder Agent – in jeder Sandbox – erhält sie auf zwei Arten zurück:

• einen entfernten MCP-Endpunkt (/mcp) mit kompakten Meta-Tools (keine Tool-Listen-Aufblähung), und

• eine CLI (scriptit), die ein Agent aus jeder Sandbox heraus über einen Public-Key-Handshake koppeln kann, der über einen MCP-Tool-Aufruf genehmigt wird – Upstream-Anmeldedaten gelangen nie in die Sandbox.

Dazu ein proxierter LLM-Endpunkt für Skripte und Watches: Führe einen Befehl oder ein Tool in einem Intervall aus, optional mit LLM-Überprüfung der Ausgabe, und sende strukturierte Ereignisse, die dein Agent abrufen oder streamen kann.

Lokal zuerst: Alles läuft auf deinem Rechner (SQLite, ein Serverprozess).

Schnellstart

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

Entwicklungsmodus (Server + Web-UI + Demo-Upstream-MCP, alles überwacht):

pnpm dev

• Dashboard: http://127.0.0.1:4747 (Dev-UI: http://127.0.0.1:5173) – melde dich mit dem Admin-Token an.

• Demo-Upstream-MCP-Server: http://127.0.0.1:4748/mcp (echo, get_time, list_cronjobs).

• LLM-Funktionen benötigen ANTHROPIC_API_KEY (oder ein ant auth login-Profil) in der Umgebung des Servers.

Related MCP server: cloud-to-local

Agent verbinden (MCP)

Zu Claude Code (oder einem beliebigen MCP-Client) hinzufügen:

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

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

CLI koppeln (der Handshake)

In der Sandbox / in einer beliebigen Shell:

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

Bitte dann deinen Agenten, approve_cli mit diesem Code über seine ScriptIt-MCP-Verbindung aufzurufen, oder genehmige es im Dashboard. Ab dann:

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

Die CLI signiert jede Anfrage mit einem ed25519-Schlüssel; Sitzungen sind kurzlebig und können im Dashboard widerrufen werden. Upstream-Tokens leben nur in der Steuerungsebene, verschlüsselt im Ruhezustand.

Aufbau

Hinweise

• Lokaler Build vertraut localhost: Admin-/MCP-Tokens sind die Auth-Grenze. 4747 nicht freigeben.

• OAuth-Connectors verwenden Dynamic Client Registration + PKCE (funktioniert mit Linear, Notion, Sentry, Atlassian, Stripe, Supabase, …). Bearer/PAT-Connectors decken GitHub's MCP und Verwandtes ab.

• scriptit watch-Befehls-Watches führen Shell-Befehle auf dem Server-Host aus – das ist der Sinn (lokaler Build), aber denk daran, wenn du das irgendwo geteilt bereitstellst.