Docs

Connect your AI assistant to Shopvisly

Add one MCP server URL to ChatGPT, Claude, Grok Bot, Gemini CLI, GitHub Copilot or Cursor, approve the sign-in, and ask your assistant about your store’s SEO and AI visibility.

MCP server URLhttps://app.shopvisly.com/mcp

Shopvisly runs a remote Model Context Protocol (MCP) server over Streamable HTTP. Your assistant signs in with OAuth: the server publishes its OAuth metadata and supports dynamic client registration, so most clients open a Shopvisly sign-in page in your browser by themselves. Enter the URL in full, including https://.

Set up your agent

The quickest route is the setup prompt in the app:

  1. Sign in at app.shopvisly.com and open Agent setup.
  2. Select Copy setup prompt and paste it into your assistant.
  3. The assistant connects Shopvisly where it can and tells you which steps you need to do yourself, such as approving the sign-in.

Prefer to do it by hand? Use the steps for your assistant below. They all use the same URL: https://app.shopvisly.com/mcp.

Connect by hand

ChatGPT

  1. In ChatGPT on the web, open Plugins, select the + button and choose Add custom MCP server.
  2. Name it Shopvisly. Under Connection, enter https://app.shopvisly.com/mcp.
  3. Choose OAuth as the authentication, tick I understand and want to continue and select Create as a plugin.
  4. Sign in to Shopvisly and approve the connection.
  5. Start a new chat, type @, select Shopvisly and ask it to check the connection and list your projects.

Custom MCP servers depend on your ChatGPT plan and workspace. OpenAI currently offers full MCP support on Business and Enterprise/Edu, where an admin or owner may need to add and publish the connection. Older accounts may still show the legacy flow under Settings → Apps → Create. If ChatGPT rejects the address, check that you entered the full https:// URL.

After a Shopvisly update: open the connection’s details and select Refresh, then start a new chat. In a workspace, an admin refreshes the tool list from the workspace app settings.

Source: OpenAI Help Center: Connecting custom MCP servers in ChatGPT

Claude (claude.ai, Claude Desktop, Cowork)

  1. Go to Customize → Connectors, select + Add and then Add custom connector.
  2. Name it Shopvisly, enter https://app.shopvisly.com/mcp and select Continue.
  3. Under Authentication, choose Sign in now or Sign in when needed.
  4. Under OAuth client, choose Register automatically. Shopvisly supports dynamic client registration. Leave the request headers empty.
  5. Select Add, sign in to Shopvisly and approve. Turn the connector on in a chat with + → Connectors.

On Team and Enterprise plans an owner adds the connector under Organization settings → Connectors first; members then select Connect. Anthropic limits Free plans to one custom connector.

Source: Claude Help Center: custom connectors using remote MCP

Claude Code

claude mcp add --transport http shopvisly https://app.shopvisly.com/mcp

Start a session, run /mcp, select Shopvisly and complete the sign-in in your browser.

Source: Claude Code docs: Connect Claude Code to tools via MCP

Grok Bot

  1. Open a chat with your Bot and send: Add this MCP server: https://app.shopvisly.com/mcp
  2. Confirm the server name and URL when the Bot asks.
  3. Choose the sign-in card the Bot posts, then sign in to Shopvisly and approve.
  4. Ask the Bot to check its Shopvisly connection and list your projects.

The connection is saved to your account, so your other Bots can use it too. In Grok chat on grok.com, go to grok.com/connectors, select New Connector → Custom and enter the same URL. On Grok Business and Enterprise, an admin adds the connector first.

Source: xAI docs: Connectors (custom MCP connectors)

Gemini CLI

gemini mcp add --transport http --scope user shopvisly https://app.shopvisly.com/mcp

Gemini CLI detects that Shopvisly needs OAuth and registers itself. In a session, run /mcp auth shopvisly to sign in, and /mcp list to check the status.

Source: Gemini CLI docs: MCP servers with Gemini CLI

GitHub Copilot in VS Code

  1. Run Chat: Open Customizations from the Command Palette, select MCP Servers and then Add Server (+). You can also run MCP: Add Server.
  2. Choose HTTP, enter https://app.shopvisly.com/mcp and use shopvisly as the server ID.
  3. Select Global → Copilot Global to use it in all your workspaces.
  4. Accept the trust prompt and complete the Shopvisly sign-in.

Source: VS Code docs: Add and use MCP servers in VS Code

Cursor

Add Shopvisly to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "shopvisly": {
      "url": "https://app.shopvisly.com/mcp"
    }
  }
}

Cursor uses OAuth with dynamic client registration for remote servers. Open the MCP list in Cursor’s Customize page and sign in to Shopvisly when it asks.

Source: Cursor docs: Model Context Protocol (MCP)

Other MCP clients

Any client that supports remote MCP servers over Streamable HTTP can connect. Clients with OAuth discovery sign in on their own. Others can send an API key as a header.

Use an API key instead of OAuth

For remote agents where the browser sign-in does not work:

  1. In Shopvisly, open Settings and select Create API key under API keys.
  2. Store the key in your client’s secret settings or an environment variable. Never paste it into a chat or commit it to a repository.
  3. Send it with every request as Authorization: Bearer <key> or x-api-key: <key>.
claude mcp add --transport http shopvisly https://app.shopvisly.com/mcp \
  --header "Authorization: Bearer $SHOPVISLY_API_KEY"

An API key acts for the organization it was created in. Delete it in Settings when you no longer need it.

Check the connection

Ask your assistant: “Use Shopvisly to check my connection and list my projects.” It should call the whoami and list_projects tools. Both are free. If you have no projects yet, ask it to create one for your website. Creating a project uses no credits.

A connected server alone does not prove the tools work in your current chat. If the tools do not show up, start a new chat or reload the client.

Shopvisly skills

Skills are ready-made workflows that tell your assistant how to use Shopvisly’s tools for a full job. The setup prompt installs them in assistants that support skills. You can also find them in the app under Agent setup → Skills. Run one by name when you want a full report instead of a quick answer.

  • seo-coach: Explains where you stand and picks your next step.
  • seo-project-setup: Saves your goals, competitors, and key pages as shared context.
  • seo-audit: One-page site audit built around a single do-this-week action.
  • ai-visibility-audit: Finds the few changes most likely to get you cited in AI answers.
  • ai-prompt-research: Finds what people ask ChatGPT about your market and who gets cited.
  • keyword-research: Finds keyword opportunities from a few seed topics.
  • keyword-clustering: Groups keywords by intent and maps them to pages.
  • competitive-landscape: Maps who wins in your market and why.
  • competitor-analysis: Studies one competitor's keywords, content, and backlinks.
  • link-prospecting: Finds link prospects and drafts outreach.
  • local-seo: Audits a Google Business Profile and Maps visibility.
  • seo-report: Saves any of the above as a report on your Reports page.

Assistants without skill support can still use every Shopvisly tool. Just describe what you want in plain language.

Update your skills

  • Custom MCP connection: refresh the connection in your client (in ChatGPT: Refresh in its details), then start a new chat. Refreshing updates the tools, not skill files.
  • Installed skills: copy the update prompt from Agent setup and paste it into your assistant. It updates only the Shopvisly skills and keeps your connection, sign-in and your own edits.
  • Reload skills or start a new session afterwards, as your assistant requires.

Sign-in expired or revoked

If your assistant reports that your Shopvisly sign-in has expired or was revoked, reconnect Shopvisly in the assistant’s connector settings and approve the sign-in again. If the client keeps an old registration, remove the Shopvisly connection and add it again with the same URL.

Troubleshooting

  • The client says the URL is unsafe or invalid. Enter https://app.shopvisly.com/mcp in full, including https:// and /mcp.
  • 401 invalid API key. The key is wrong, expired or deleted. Create a new one in Settings.
  • 403 access revoked. The key no longer belongs to an organization you are a member of.
  • 429 rate limited. Wait for the time in the Retry-After header, then try again.
  • Still stuck? Email support@shopvisly.com with the name of your assistant and the error message. Never send API keys or passwords.

FAQ

Does connecting an assistant cost credits?

No. Connecting, signing in, checking the connection and listing your projects are free. Research tools that use paid data, such as keyword research or rank checks, use usage credits as they do in the app.

Do I need an API key?

Usually not. Most assistants sign in with OAuth in your browser. Use an API key only for clients or remote agents where the browser sign-in does not work.