Claude

This guide covers claude.ai (the web app) and Claude Desktop. For the terminal agent, see Claude Code · it has its own one-command setup.

Connect

1. In Claude's connector settings, add a new connector with the Soil MCP URL. There is no config file to edit · the connector is added entirely in Claude's settings:

   https://mcp.nativesoil.dev/mcp/soil

2. Sign in when prompted · with Google, or with email and password. You don't supply a client id or secret; Claude registers itself automatically (Soil's OAuth bridge implements Dynamic Client Registration).

3. In a conversation, run soil info to confirm: it returns your project and handover counts, which proves Claude reached Soil and is authenticated.

A 1-click Claude Connectors Directory listing is planned · it needs work on our side · but the custom-connector steps above work today.

Use Soil

The commands are the same in every client · same grammar, same account. You type them in plain language in the conversation; the model calls the matching Soil tool. @ says where, # says which:

soil save                       save this conversation as a graded handover
soil save #my-name              save under your own name · kept, never overwritten
soil save #my-name @project     add to a shared project · either order
soil list                       your handovers · soil list @project for a team
soil load #001                  load by exact code · by name: soil load #my-thread
soil load @project              whole-project restore · #NNN or #name for one thread
soil info                       your account status · the connection check

Save in this client, load in any other. See the soil commands for details and the reference for every form.