Install ChatData Plugin + MCP in Claude Code

Use these steps in order for a fresh Claude Code session. The plugin enforces the analytics workflow; the MCP keeps shared context, proof, metric packets, and answer paths synced.

1. Install or update the ChatData Claude plugin.

   The plugin gives Claude Code the ChatData commands and the principal workflow harness. If the marketplace or plugin already exists, continue with the update and verify commands.

   Add marketplace Copy

   claude plugin marketplace add https://github.com/getchatdata/chatdata-claude-marketplace.git

   Install plugin Copy

   claude plugin install chatdata@chatdata

   Already installed update Copy

   claude plugin update chatdata@chatdata

   Verify plugin Copy

   claude plugin list

   Expected plugin check: chatdata@chatdata is enabled. Restart Claude Code after plugin install or update.

2. Save your ChatData config.

   Click the button, paste once into macOS Terminal, and press Return. Do not copy individual JSON lines like token:, workspace_id:, or domain:.

   Terminal command

   Copy terminal setup command Copy JSON for debugging

   Loading saved setup command.

   Expected final line in Terminal: Saved ChatData config to $HOME/.chatdata/config.json. The JSON button is only for support or manual file editing.

3. Build the local MCP package once.

   Paste this into Terminal from any folder. If it ends without an error, the server file exists at packages/mcp/dist/index.js.

   Terminal command Copy

   cd /Users/parasdoshi/Documents/ChatData/packages/mcp && npm install && npm run build

4. Add ChatData to Claude Code.

   Paste this into Terminal. It tells Claude Code to launch the ChatData MCP server by name.

   Claude Code command Copy

   claude mcp add --scope user chatdata -- node /Users/parasdoshi/Documents/ChatData/packages/mcp/dist/index.js

   If Terminal says MCP server chatdata already exists in user config, you are already connected. Run the details command below and continue if it shows Status: Connected, Command: node, and the ChatData packages/mcp/dist/index.js path.

   Already connected check Copy

   claude mcp get chatdata

   Only use this reset command if the details command points to an old or wrong path. It removes Claude's MCP pointer and adds the correct one again; it does not delete your ChatData config or workspace data.

   Reset wrong Claude entry Copy

   claude mcp remove chatdata -s user && claude mcp add --scope user chatdata -- node /Users/parasdoshi/Documents/ChatData/packages/mcp/dist/index.js

5. Using Codex instead?

   Skip this if you only use Claude Code. For Codex, paste this into Terminal after the build command.

   Codex command Copy

   codex mcp add chatdata -- node /Users/parasdoshi/Documents/ChatData/packages/mcp/dist/index.js

6. Restart Claude Code, then verify.

   Close the current Claude Code session, open a fresh one, and run the list command in Terminal. You should see chatdata.

   Terminal command Copy

   claude mcp list

7. Ask Claude to run the doctor tool.

   Paste this exact sentence into the new Claude Code chat. Do not type only chatdata_doctor.

   Claude chat message Copy

   Use the ChatData MCP server and run the chatdata_doctor tool. Show me the JSON result.

Data boundaries