Start here

Install and authenticate

Set up the SDK, CLI, MCP, API key, and production host in one place.

On this page

Install the ComputeSDK package

Install the first-party TypeScript package for the standard provider and Zeish session client.

The package is @zeish/computesdk-provider. It includes the portable ComputeSDK provider, a typed public API client, and the richer Zeish sandbox session client.

Use Node.js with a server-side environment. Keep ZEISH_API_KEY out of browser bundles and client-side source.

terminal

1npm install @zeish/computesdk-provider

Install zeishctl

Install a published zeishctl release from the public download service.

The CLI binary is named zeishctl and also accepts the aliases zctl and zc.

Get the current version and platform download URLs from https://api.zei.sh/api/v1/cli/versions. The public service provides Linux x86_64, macOS arm64, macOS x86_64, and Windows x86_64 archives.

terminal

1curl -fsSL https://api.zei.sh/api/v1/cli/versions2zeishctl --help

Connect an MCP client

Connect Claude, ChatGPT, or another MCP client over Streamable HTTP.

MCP is hosted by Zeish. There is no local package to install for the hosted connection.

Use the endpoint below for headless API-key access. Interactive clients can use OAuth Authorization Code with PKCE and dynamic client registration.

terminal

1{2  "mcpServers": {3    "zeish": {4      "url": "https://api.zei.sh/api/v1/mcp",5      "headers": {6        "Authorization": "Bearer zeish_live_..."7      }8    }9  }10}

Create an API key

Create a server credential for the REST API, SDK, CLI, or headless MCP.

Create a standalone API key from the dashboard Limits page. The full value is shown once, stored as a hash, and starts with zeish_live_.

Choose only the permissions the integration needs. Public API permissions include MACHINE_READ, MACHINE_CREATE, MACHINE_UPDATE, MACHINE_DELETE, and ORG_MANAGE.

API keys are bearer credentials. Store them in a secret manager or environment variable. Never put one in a browser bundle, source control, logs, or a command copied into a shared shell history.

terminal

1export ZEISH_API_KEY="zeish_live_..."

Configure the production host

Use the correct base URL in each client.

The REST API base is https://api.zei.sh/api/v1. The CLI base host is https://api.zei.sh and it adds the versioned path for API calls.

Set the SDK baseUrl explicitly. The package default is not the production Zeish host.

terminal

1const baseUrl = "https://api.zei.sh/api/v1";2const cliHost = "https://api.zei.sh";