MCP

The Nuxt SEO Pro MCP server exposes your Site data to an AI client. It has its own tool catalog. The server marks this transitional transport as deprecated. Prefer the CLI or public API for new integrations.

Use MCP when your client cannot run a terminal. If your client has a terminal, use the CLI instead. The CLI has exit codes and pipes, so a script can act on a result.

Endpoint

Connect with OAuth

The server publishes OAuth discovery metadata at the endpoints below. Your client must complete authorization and consent before it can read Team data. If a client cannot complete OAuth, use the CLI or a client that supports a Team API token header.

For this protected endpoint, use OAuth in ChatGPT or Claude's remote connector UI. Use a supported coding client for Team API token headers.

ChatGPT

1. Follow OpenAI's current developer mode instructions. Availability depends on your plan and workspace permissions.
2. Create an app under Settings > Apps.
3. Enter https://nuxtseo.com/mcp/pro and choose OAuth.
4. Complete authorization, approve the intended Team, and finish the tool scan.

Claude.ai

Follow Claude's remote connector instructions. Add https://nuxtseo.com/mcp/pro under Settings > Connectors, then complete authorization. Claude Desktop uses this connector flow too.

The server exposes discovery metadata. Successful discovery alone does not establish a completed authorization grant. The server publishes RFC 9728 metadata at /.well-known/oauth-protected-resource/mcp/pro and RFC 8414 metadata at /.well-known/oauth-authorization-server. Client registration is dynamic, so there is no client ID to copy.

Protocol endpoints:

Scopes:

A grant is scoped to one Team, not to one user. Your role is read from live membership on every request, so a demoted member loses write access at once.

Connect with a Team API token

Mint a token under Settings, then API tokens. A token starts with nsp_. Send it as Authorization: Bearer <token>.

Claude Code:

claude mcp add nuxt-seo-pro https://nuxtseo.com/mcp/pro \
  --transport http \
  -H "Authorization: Bearer nsp_your_token"

For Cursor and Windsurf, follow the client's current remote HTTP configuration documentation. Do not use local Claude Desktop server JSON for a remote connector.

VS Code with GitHub Copilot uses this configuration in .vscode/mcp.json:

{
  "servers": {
    "nuxt-seo-pro": {
      "type": "http",
      "url": "https://nuxtseo.com/mcp/pro",
      "headers": { "Authorization": "Bearer nsp_your_token" }
    }
  }
}

Gemini CLI:

{
  "mcpServers": {
    "nuxt-seo-pro": {
      "httpUrl": "https://nuxtseo.com/mcp/pro",
      "headers": { "Authorization": "Bearer nsp_your_token" }
    }
  }
}

Codex CLI:

[mcp_servers.nuxt-seo-pro]
url = "https://nuxtseo.com/mcp/pro"
bearer_token_env_var = "NUXTSEO_TOKEN"

Set NUXTSEO_TOKEN in the environment that starts Codex. Keep real tokens out of shared configuration files.

What the tools reach

The transitional tool catalog includes:

• Next Actions and Page Issues
• Organic Search rows and Search Indexing diagnostics
• Lighthouse audits, Core Web Vitals, and their findings
• Crawl changes, duplicate clusters, and internal link structure
• Keyword research, competitors, backlinks, and mentions
• Content decay and timeline annotations
• Site list and account usage

Read tools accept any Team role with the required entitlement. Write tools need the editor or admin role. An OAuth grant also needs mcp:write.

A write tool called with a viewer token returns an authorization error. Check role and OAuth scopes before retrying.

Revoke access

Revoke a Team API token under Settings, then API tokens. Revoking stops the CLI, the API, and any MCP client using that token.