How to Connect Claude, ChatGPT, or Gemini to Linkilo (MCP)

Linkilo 2.9 and later include a built-in MCP (Model Context Protocol) server, which means AI assistants like Claude, ChatGPT, and Gemini can read your site’s internal-linking data — orphan pages, anchors, cannibalization, broken links, Search Console queries, link equity, topic clusters and more — and answer questions about it in plain English. In Linkilo 3.0 they can also generate client-ready reports from your saved report profiles.

Before you start

• Linkilo 2.9 or newer installed.
• MCP access turned ON: go to Linkilo → Manage → MCP Access, tick Enable MCP access, then click Save. It is off by default — the connector cannot connect while it’s off.

Connecting from claude.ai (or ChatGPT / Gemini web)

Important: you do not use a token for web connectors. Never paste a token into the URL or anywhere else — the Connect button uses a sign-in flow instead.

1. Copy your Connection endpoint from Linkilo → Manage → MCP Access. It looks like https://yoursite.com/wp-json/linkilo-mcp/v1/rpc
2. In claude.ai go to Settings → Connectors → Add → Add custom connector.
3. Give it a name (e.g. “Linkilo”) and paste only the URL. Leave the “OAuth Client ID” and “OAuth Client Secret” fields empty.
4. Click Add, then Connect.
5. A browser window opens your WordPress admin (log in if asked). You’ll see an Authorize MCP access screen showing which app is asking. Pick the Access level — start with read_only (recommended) — and when the connection Expires (30 days, 90 days or 1 year) before it must be re-approved.
6. Click Approve. You’re returned to the AI app, now connected.

What can it do once connected?

Ask things like “Which of my pages have the most impressions but no internal links?”, “Show my broken links”, “Suggest internal links for this post”, or “Generate the Client Summary report for the last 30 days”. With a read_only connection the assistant can only look — it cannot change anything on your site. Everything it reads is data Linkilo already stored; MCP never calls your AI provider or spends your OpenAI key.

Managing or removing the connection

Every connection appears under Linkilo → Manage → MCP Access → Issued tokens (sign-in connections are labeled OAuth: <app name>). Click Revoke and the app loses access immediately. The Recent MCP activity table on the same page shows the last 20 tool calls any assistant made — including refused ones.

Troubleshooting

• “Couldn’t register with the sign-in service” — see Fix “Couldn’t Register with the Sign-In Service” When Connecting MCP.
• Nothing happens after Approve — delete the connector in the AI app and add it again fresh; old failed attempts can cache a bad state.
• Using Claude Code or another desktop client? Those use a token instead — see How to Connect Claude Code and Desktop MCP Clients with a Token.

Last reviewed for Linkilo 3.0.0 (October 2026).