# CraftTable MCP CLI

`@game-crafttable/mcp-client` provides the `crafttable-mcp` command and the compatibility alias `crafttable-mcp-client`.

## Quick install and configure

The repository is private, so first make sure Git Credential Manager can access `git.crash.work`, then run this in PowerShell:

```powershell
npm install --global git+https://git.crash.work/cneicy/crafttable-mcp-client.git; crafttable-mcp login; crafttable-mcp configure all
```

This installs the CLI, opens the browser for OAuth login, and configures the same local stdio bridge for Codex, Claude Code, and OpenCode at user scope.

## Commands

```powershell
crafttable-mcp login
crafttable-mcp status
crafttable-mcp tools
crafttable-mcp call list_spaces '{}'
crafttable-mcp configure all
```

`login` uses Authorization Code with PKCE and saves OAuth tokens in the operating-system credential store. Tokens are isolated by MCP server URL and OAuth client ID. The CLI never falls back to a plaintext token file.

`serve` is a stdio MCP bridge for Codex, Claude Code, and OpenCode. It writes MCP JSON-RPC only to stdout. If no OAuth credential exists, it can use the legacy `CRAFTTABLE_MCP_TOKEN` environment variable and reports that path only on stderr.

Connection defaults:

- URL: `https://crafttable.crash.work/mcp`
- OAuth client ID: `crafttable-mcp-cli`
- callback: `http://127.0.0.1:48321/oauth/callback`

Override them with `--url`, `--client-id`, and `--callback-port`, or with `CRAFTTABLE_MCP_URL`, `CRAFTTABLE_MCP_OAUTH_CLIENT_ID`, and `CRAFTTABLE_MCP_OAUTH_CALLBACK_PORT`.

Only HTTPS remote URLs are accepted. Plain HTTP is limited to `localhost`, `127.0.0.1`, and `::1` development servers.