How to connect Fine Structure to Claude Code with MCP

A guide for non-technical users who want to let Claude Code build, test, and improve Fine Structure apps through MCP.

Claude Code can work with Fine Structure like a teammate who already knows the system: it can read your app's structure, understand the files, suggest a change, run system checks, and ask to publish only when it has the right permission. The connection is made through MCP, which means a controlled token rather than a personal password.

What this gives you: You can ask Claude Code to build a new screen, fix an error, check a version before publishing, or prepare a change for a client, all without manually copying files out of the system.

Who it's for: Business owners, agencies, and product managers who want an AI agent to work on the product within clear boundaries.

How safe is it: The token is limited by app and permissions. You can create a Read only token for testing, a Build token for working, or Full access only when you trust the agent.

Step one: create an MCP token

Open the MCP page, create a new token, and copy the value that starts with fse2_mcp_. Without the token, Claude Code cannot access your Fine Structure account.

Simple steps

• Sign in to your Fine Structure account.
• Open the MCP page using the Create MCP token button in the docs, or go directly to /mcp.
• Choose whether the agent gets access to all the apps you own or to a single app only.
• Choose permissions: Read only for testing, Build for editing, Full access only for an agent you trust.
• Click Create MCP setup and copy the token or the configuration block. The token is shown only once.
• Open a Terminal in the project folder where you work with Claude Code.
• Paste the command below and replace fse2_mcp_<token> with your own token.
• Open Claude Code and type /mcp to confirm that the fine-structure server is connected.

claude mcp add --transport http fine-structure https://finestructure.ai/api/mcp --header "Authorization: Bearer fse2_mcp_<token>"

{
  "mcpServers": {
    "fine-structure": {
      "type": "http",
      "url": "https://finestructure.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer fse2_mcp_<token>"
      }
    }
  }
}

What to tell Claude after connecting

• Ask the agent: "Use the Fine Structure MCP and call get_platform_guide first."
• If you're working on an existing app, also give the app name or app_id.
• Before publishing or making a major change, ask the agent to run validate_app and inspect_preview.
• If the connection fails, create a new token at /mcp and revoke the old one so you don't leave access open.

Internal marketing tip: If you're an agency, create a token locked to a single app for each client. That way Claude Code gets exactly the relevant project and not your whole account.