// ============================================================================
// mcp-config-EXAMPLE.json  —  READ THIS, DON'T RUN IT
// ============================================================================
//
// This is a teaching example. It shows the SHAPE of an ".mcp.json" file — one
// of the three ways to add a connection (the "universal adapter," MCP) that
// connects Claude to an outside service. Your real file will look a little
// different, and the current, exact setup lives in the Companion Pack download
// and at https://code.claude.com/docs — this corner of the software changes
// fast, so treat the layout below as "the idea," not a form to copy word-for-word.
//
// The ONE lesson to take from this file:
//   A key or secret goes in the CONFIG (the "env" section below).
//   It NEVER goes in a prompt, a chat message, or a note you send anyone.
//   A secret is a house key — you don't tape it to the door.
//
// A real .mcp.json is strict JSON and CANNOT contain comments (the "//" lines).
// The comments here are only to explain the parts. In a real file, delete them.
// ============================================================================
{
  "mcpServers": {

    // Each entry under "mcpServers" is one connection. The name on the left
    // ("documents-readonly") is just a label you choose so you can recognize it.
    "documents-readonly": {

      // "command" and "args" tell Claude how to start this connection.
      // (What you actually put here comes from the service's own setup guide —
      // follow the current walkthrough in the Companion Pack.)
      "command": "the-connector-program",
      "args": ["--folder", "your-documents-folder"],

      // "env" is where secrets live — safely, in config, never in a prompt.
      // The value below is a PLACEHOLDER, not a real key. When you set this up
      // for real, you paste YOUR key here in the config file, on your own
      // computer — and nowhere else.
      "env": {
        "SERVICE_API_KEY": "PUT-YOUR-KEY-IN-CONFIG-NOT-HERE"
      }
    }

    // You could have more connections here, each its own labeled block.
    // Start with ONE, read-only, and only add more once it's earned your trust.
  }
}