Claude Code setup

Claude Code setup

Claude Code supports a project-scoped .mcp.json in the repository root. OAuth is recommended — no secrets in the file.

1. Create an OAuth application — see the OAuth application setup guide with the forms scope.
2. Add redirect URIs: http://127.0.0.1/callback and/or http://localhost/callback (loopback RFC 8252).
3. Create a .mcp.json file in the project root (OAuth, recommended):

{
    "mcpServers": {
        "formdesigner": {
            "type": "http",
            "url": "https://mcp.formdesigner.pro/v1/mcp"
        }
    }
}

Run /mcp in Claude Code and complete OAuth in the browser.

Alternative — client credentials via environment variables (requires useClientCredentials in the OAuth app):

{
    "mcpServers": {
        "formdesigner": {
            "type": "http",
            "url": "https://mcp.formdesigner.pro/v1/mcp",
            "headers": {
                "X-Client-Id": "${FORMDESIGNER_MCP_CLIENT_ID}",
                "X-Client-Secret": "${FORMDESIGNER_MCP_CLIENT_SECRET}"
            }
        }
    }
}