Skip to content

Docs: Updating Claude Code for Configuration Discrepancy#1045

Merged
sscargal merged 4 commits into
MemMachine:mainfrom
SarahScargall:claude
Mar 4, 2026
Merged

Docs: Updating Claude Code for Configuration Discrepancy#1045
sscargal merged 4 commits into
MemMachine:mainfrom
SarahScargall:claude

Conversation

@SarahScargall

@SarahScargall SarahScargall commented Feb 3, 2026

Copy link
Copy Markdown
Contributor

Purpose of the change

This PR corrects a critical configuration discrepancy in the Claude Code MCP Integration Guide. Previously, the documentation incorrectly directed users to use claude_desktop_config.json, which led to connection failures for Claude Code CLI users who require a different configuration path.

Description

Updated the claude_code_mcp.mdx file to reflect the specific configuration requirements for Claude Code:

  • Replaced references to claude_desktop_config.json with the project-level .mcp.json.
  • Added a requirement for maintaining persistent settings via ./.claude/settings.local.json.
  • Refactored both Docker (Option A) and Direct Command (Option B) setup guides to use the correct project-root pathing.
  • Updated the verification command to /MCP to match lab-verified behavior for the CLI tool.
  • Standardized parameter documentation using a Mintlify-native table for improved scannability.

Fixes/Closes

Fixes #976 Claud Code Setup

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • Documentation update

How Has This Been Tested?

Verification was based on a Conflict Report provided by engineering regarding the distinction between Desktop and CLI configurations:

  1. Manual verification: Confirmed that Claude Code searches for .mcp.json at the project root rather than the global desktop config.
  2. Path Verification: Verified that persistence requires entries in .claude/settings.local.json at the working directory level.
  3. Command Check: Verified /MCP as the correct trigger command within the Claude Code CLI environment.

Test Results: Lab-verified by engineering team findings.

Checklist

  • I have signed the commit(s) within this pull request
  • My code follows the style guidelines of this project (See STYLE_GUIDE.md)
  • I have performed a self-review of my own code
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have checked my code and corrected any misspellings

Maintainer Checklist

  • Confirmed all checks passed
  • Contributor has signed the commit(s)
  • Reviewed the code
  • Run, Tested, and Verified the change(s) work as expected

Screenshots/Gifs

Top of Document in Mintlify Environment (image 1):
Screenshot 2026-02-03 at 4 25 47 PM

Next "page" down within this document (image 2):
Screenshot 2026-02-03 at 4 28 51 PM

"Page" after that (image 3):
Screenshot 2026-02-03 at 4 29 25 PM

And after that (image 4):
Screenshot 2026-02-03 at 4 30 02 PM

Step 4 onward (image 5):
Screenshot 2026-02-03 at 4 31 03 PM

Remainder of Page (image 6 ):
Screenshot 2026-02-03 at 4 31 42 PM

Further comments

This update is essential to prevent user friction for those migrating from Claude Desktop to Claude Code, as the configuration files and paths do not overlap between the two platforms.

@SarahScargall
Updating Claude Code for config file clarifications
78f2151 
Signed-off-by: Sarah Scargall <sarah.scargall@memverge.com>
@SarahScargall SarahScargall added the documentation Issues related to documentation label Feb 10, 2026
sscargal
sscargal approved these changes Mar 4, 2026
View reviewed changes

@sscargal sscargal left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@jgong

jgong commented Mar 4, 2026

Copy link
Copy Markdown
Contributor

I can successfully add memmachine mcp server with this config

/mcp shows

 Manage MCP servers
 3 servers

   Project MCPs (/Users/jinggong/memmachine/MemMachine/.mcp.json)
 ❯ memmachine · ✔ connected

called the mcp add_memory tool

❯ remember that When a question has multiple possible solutions, focus on the one you’d most recommend in
  practice. Explain that one thoroughly. For alternative approaches, you may briefly list or summarize them, but
   don’t expand on them unless the user specifically asks.


⏺ memmachine - add_memory (MCP)(content: "User preference: When a question has multiple possible solutions, focus on
                               the one most recommended in practice. Explain that one thoroughly. For alternative
                               approaches, briefly list or summarize them, but do not expand unless the user
                               specifically asks.")
  ⎿  {
       "status": 200,
       "message": "Success"
     }

⏺ Saved.

@sscargal sscargal merged commit d76dcc7 into MemMachine:main Mar 4, 2026
42 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@jgong jgong jgong approved these changes

@sscargal sscargal sscargal approved these changes

@ChristianKniep ChristianKniep Awaiting requested review from ChristianKniep

Assignees

No one assigned

Labels

documentation Issues related to documentation

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[Docs]: Claud Code Setup

3 participants

@SarahScargall @jgong @sscargal