# Claude Code MCP: add 1folder so your plans and handoffs are kept

> Add 1folder to Claude Code and it can save plans, handoffs and reports to files you open anywhere, and Codex or ChatGPT can pick them up. Run claude mcp add --transport http 1folder https://1folderapp.com/mcp, start Claude Code, open /mcp and sign in to 1folder. Choose the folders it may read or edit, then ask it to save a handoff and open the link.

*Picture: Claude Code (saves the current task and its checks) connected to one 1folder holding Release handoff (a page saved by Claude Code, version 2) and Acceptance criteria (a page saved by you).* Claude Code saves Release handoff beside your acceptance criteria. The next session can read the current handoff, with a version showing each saved update.

## Connect Claude Code to 1folder

1. **Add 1folder from your terminal.** Run claude mcp add --transport http 1folder https://1folderapp.com/mcp. This registers the remote address; it does not yet prove that the app can open your files.

   *Picture: Adding 1folder to Claude Code by typing one line: claude mcp add --transport http 1folder https://1folderapp.com/mcp*
2. **Sign in to 1folder.** Start Claude Code and enter /mcp. Select 1folder and complete its sign-in in the browser.
3. **Choose the folders and press Allow.** Pick the Release space or just the folders for this work. Choose View and edit to save files, or View only to review them, then press Allow.

   *Picture: 1folder’s Allow page: “Claude Code wants to use your 1folder”, with Only the folders I pick in Release and View and edit chosen, then Allow.*
4. **Check one saved file.** Ask Claude Code to save Release handoff and return its private link. Open the file and check the actual contents before handing over more work.

   *Picture: In Claude Code, you type: “Save Release handoff in my 1folder Release folder and give me its private link.” Claude Code saves Release handoff (a page saved by Claude Code, version 1) to 1folder.*

## Requests to try with the connected app

- In Claude Code: “Save Release handoff in 1folder: goal, branch, commit, changed files, exact checks run with results, blockers and next step. Return its private link.”
- In Claude Code: “Read Release handoff in 1folder and compare its branch and commit with this checkout before editing. Report mismatches.”
- In Claude Code: “Update the same Release handoff page with the test result below. Mark the browser check as not run.”

## What Claude Code MCP servers add

Claude Code can work with local code without this connection. An MCP server adds another service’s tools to the session. A remote server lives at a web address; a local server is started with a command on your computer. For 1folder, use the remote HTTP setup above, with no extra package to install.

The useful first result is a [handoff someone can inspect](https://1folderapp.com/how-to/claude-code-handoff.md). Keep code in your repository, and save the goal, exact revision and remaining work to a page in 1folder. This does not upload the repository or transfer the full session.

## Choose the configuration scope

| | Scope | Where it applies |
|---|---|---|
| Local | Default when no scope is supplied | Your use in the current project |
| Project | Add --scope project to the command | Stored in .mcp.json for the project; other people review and approve it |
| User | Add --scope user to the command | Your use across projects |

## Claude Code MCP add: verify registration and sign-in separately

Run claude mcp list to see configured servers and their status. Run claude mcp get 1folder to inspect this one. An “Added” result means the configuration was written; you still need a working connection and sign-in. Open /mcp in an interactive session if authentication or approval is pending.

If the server is missing in another checkout, check the scope before adding duplicates. If tools appear but saving fails, check the folder you allowed and whether the connection has View and edit. A read-only connection is enough to read a handoff, but cannot update it.

## Make the handoff worth reading

- Record the branch and commit as well as uncommitted edits. The next agent must inspect its own checkout; a page cannot put the code at the right revision.
- Write actual checks and their results. Say “not run” for anything you have not verified. A saved claim is not evidence that a test passed.
- Ask for an update to the same file. Compare versions in 1folder to see what changed, and undo an incorrect saved edit. Git remains the place to undo repository changes.
- Use a private link. Only the person can turn on a public read-only link; Claude Code cannot publish the handoff for you.

## Questions

### Do I need to run a local server for 1folder?

No. 1folder is a Claude Code remote MCP server at https://1folderapp.com/mcp. The HTTP command connects to that address rather than launching a program on your machine.

### How do I add an MCP server to Claude Code for every project?

Add --scope user to the command. The default is local scope for the current project; project scope is for a shared .mcp.json configuration.

### Why does Claude Code say it needs authentication?

Adding the server and signing in are separate steps. Open /mcp, choose 1folder and finish the browser sign-in and Allow page.

### Does it save the session automatically?

No. Ask Claude Code to save a handoff. 1folder keeps that file and its versions, not the [session history](https://1folderapp.com/how-to/does-claude-code-remember-between-sessions.md) or hidden state.

### Can I use Codex on that saved handoff?

Yes. [Connect Codex](https://1folderapp.com/integrations/codex-mcp.md) to the same folder and ask it to read the latest file. This gives Codex the saved handoff, while code changes move through your usual Git workflow.

## Sources

- [Claude Code docs: MCP reference](https://code.claude.com/docs/en/mcp)

Checked on November 11, 2026.

## Read next

- [Codex MCP: add 1folder so Codex saves and reads your files](https://1folderapp.com/integrations/codex-mcp.md): Add 1folder to Codex with codex mcp add and sign in. Codex then saves handoffs and reports to your files, where Claude Code or ChatGPT can pick them up.
- [Use Claude Code and Codex together on the same files, with Cursor too](https://1folderapp.com/integrations/claude-code-and-codex-together.md): Use Claude Code, Codex and Cursor together with a saved handoff, code revision and checks. Connect each app once and keep the next agent’s starting point clear.
- [How to use ChatGPT and Claude together on the same files](https://1folderapp.com/integrations/use-chatgpt-and-claude-together.md): Use ChatGPT and Claude together on one saved file, or add Gemini and Claude Code. Set up each app, hand over a checked draft and compare every saved revision.
- [Claude Code handoff: pass work to a new session](https://1folderapp.com/how-to/claude-code-handoff.md): Write a Claude Code handoff with the revision, changed files, checks and next steps. Compare HANDOFF.md, resume and compact, and save it to 1folder to share.

[Add 1folder to your AI app, free](https://1folderapp.com/signin) · [All resources](https://1folderapp.com/resources.md)

Website: https://1folderapp.com/ · Contact: hello@1folderapp.com