40 lines
1.9 KiB
Markdown
40 lines
1.9 KiB
Markdown
# 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 --allow-git=all 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.
|
|
|
|
The explicit `--allow-git=all` is required by npm 12, whose default policy rejects Git-based package dependencies. The repository includes the built CLI bundle, so installation does not run a build script.
|
|
|
|
## 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.
|