W4DEV

Connect claude.ai or ChatGPT

By the end of this page claude.ai or ChatGPT is connected to your site as a custom connector and can call the site’s tools. You sign in on your own site and approve a consent screen. There is no password to hand over.

Before you start

  • The site is on HTTPS and can be reached from the internet. claude.ai and ChatGPT connect from their own servers, so a site that only runs on your computer cannot be reached.
  • You can sign in to the site as a user with the manage_options capability.
  • Your claude.ai or ChatGPT plan lets you add a custom connector.

1. Switch on OAuth and copy the endpoint

  1. Go to Settings → Block Theme MCP and open the Connect tab.
  2. If the Connect an MCP client card says no way in is switched on, click Switch on under Sign in through your browser (OAuth).
  3. Copy the address under Endpoint (Streamable HTTP, POST only): with its Copy button. It looks like this:
https://example.com/wp-json/btm/v1/mcp

Then switch on the tool groups the connector should reach: Settings tab, Tool groups, Save Changes. See Tool groups and what each one allows.

2. Add the connector

  1. In claude.ai or ChatGPT, open the connector settings and add a custom connector. Where that option sits depends on the product and your plan.
  2. Give it a name you will recognise, such as your site’s name.
  3. Paste the endpoint address as the server address.
  4. Leave any OAuth client ID and client secret fields empty. The connector registers itself with your site.
  5. Save, then connect.

3. Approve the connection

Your browser opens a page on your own site titled Connect an application. If you are not signed in to WordPress, you log in first and are brought back.

Check these before you click anything:

  • It calls itself: the name the application chose. The page says “This name is unverified.” Any application can register under any name.
  • You will be sent to: the host your browser goes to next. It should belong to the service you started from.
  • Signing in as: the WordPress account the connector will act as.
  • On the site: your own site’s address.
  • The list of tool groups the connector will be able to use.

Click Approve only if you started this connection yourself. Deny sends you back and grants nothing.

Check that it worked

  • The connector shows as connected in claude.ai or ChatGPT, and lists tools whose names start with btm..
  • Ask it to call btm.site-info. The answer includes your site address and the tool groups that are on.
  • On the Connect tab of the plugin, Connected apps has a row for the connector with the account it acts as.

A connector acts with the permissions of the account that approved it, and only inside the tool groups you switched on. Tools marked destructive are approved in claude.ai or ChatGPT, not by a dialog on the site.

If something goes wrong

  • “Connection unavailable: This site is not accepting OAuth connections.” The OAuth switch is off, or the site is not on HTTPS.
  • “This connection request is not valid”. The application is not registered with the site any more, or it asked to be sent to an address it did not register. Remove the connector and add it again.
  • “This request could not be confirmed”. The consent page was left open too long. Start the connection again from the connector.
  • The connector cannot reach the site at all. Open the endpoint address in a browser. A reply from WordPress, even an error in JSON, means the address is right. No reply means a firewall or a maintenance page is in the way.

More cases are in Troubleshooting. To disconnect, see Revoke a connected app.