mcp-boilerplate-integration

Claude.AI Integration Boilerplate

You can run this to get a working Claude.AI Integration that works with Desktop and Web out of the box.

Just supply your values in .env and spin up the docker container by running docker compose up -d.

You will have to backup ./data, if you lose it, all your authenticated clients will get de-authenticated. Also Claude.AI is bugged as hell and will not allow clients to re-authenticate.

You will need some kind of reverse proxy that deals with TLS temination. I run my mcp servers on ports 7001, 7002, 7003, etc and then run a single Caddy instance mapping subdomains to local ports and deal with Let's Encrypt. If I lose the .data/ folder, i just spin up a new subdomain. It's the only way for Claude.AI to forget its cached client_id which will make it impossible for clients to re-authenticate.

You can run this stand-alone, I just don't like to clutter my OS with all the dependencies and thus keep it in a container.