Connect your agent

Connect Grok CLI

Configure Grok CLI to ship an app from your local workspace.

A coding agent connected to Shipped and your app

Prepare your connection

Complete “Set up the Shipped connector” first. You need the local connector, absolute paths, and a private SHIPPED_API_TOKEN environment variable.

This guide is for the Grok command-line coding agent. Grok’s web connectors need a remote MCP endpoint, which Shipped does not currently provide.

Add Shipped

Add this server entry to ~/.grok/config.toml. Merge it with your existing configuration so other servers stay available. Replace the sample paths with your own.

The example references your token’s environment variable. It contains no token value.

TOML
[mcp_servers.shipped]
command = "/absolute/path/to/node"
args = ["--import","/absolute/path/to/Shipped Platform/node_modules/tsx/dist/loader.mjs","/absolute/path/to/Shipped Platform/apps/mcp/src/index.ts"]

[mcp_servers.shipped.env]
SHIPPED_API_URL = "https://app.shippedit.io"
SHIPPED_WORKSPACE_ROOT = "/absolute/path/to/your/app"
SHIPPED_API_TOKEN = "${SHIPPED_API_TOKEN}"

Check the tools

Run grok mcp doctor shipped to check the connection. In a Grok session, /mcps shows your servers.

Ask the agent to list your Shipped projects. Confirm the workspace before giving it a deployment instruction.

Prompt
List my Shipped projects, then help me plan this app’s deployment.

Client configuration checked October 15, 2026. Official Grok CLI MCP documentation.