Skip to content
ansvra.Documentation
Overview
Overview

Connect Ansvra to your AI assistant

Choose your assistant, connect a project, and ask your first question about saved Ansvra results.

Ansvra guides·5 min read

Before you connect

MCP is how your assistant connects to Ansvra to read saved project results. You’ll need access to a project on an active paid Ansvra account. You can manage approved sign-ins under Account settings → Connections & usage → AI connections.

Ansvra connection address
https://app.ansvra.com/mcp
text

Copy this address, then find your assistant below. When your assistant supports Ansvra sign-in, you can choose which project it may read.

Choose your assistant

ChatGPT

Use ChatGPT on the web in a workspace that allows custom MCP server connections. In Business, an admin or owner adds the plugin. In Enterprise and Edu, admins can also give selected members permission to add one.

  1. Add a custom server

    Open ChatGPT Plugins, select +, then Add custom MCP server. Name it Ansvra and paste the connection address into Server URL.

  2. Choose how to sign in

    For Authentication, choose OAuth. If asked how ChatGPT should identify itself, choose the client ID metadata document (CIMD) option. Review the warning, then select I understand and want to continue and Create as a plugin.

  3. Install and use Ansvra

    Open the new plugin and install it. Start a new chat, type @, and select Ansvra. When ChatGPT prompts you to connect, sign in to Ansvra, choose your project, and select Allow read access.

If your workspace still shows Apps, follow OpenAI’s custom app instructions. Verify the connection.

Claude

Use Claude on the web or in Claude Desktop. Claude Free allows one custom connector. On Team and Enterprise plans, an owner can add Ansvra under Organization settings → Connectors → Add → Custom → Web. If Ansvra already appears in your connectors, select Connect and continue to sign-in.

  1. Add a custom connector

    Open Customize → Connectors, select + Add, then Add custom connector. Enter Ansvra as the name, paste the connection address, and select Continue.

  2. Sign in and choose your project

    Review the detected settings and continue. Choose Sign in now and Use Claude’s published identity when offered, then add the connector. Sign in to Ansvra, select your project, and choose Allow read access.

  3. Enable Ansvra for your chat

    In a new chat, select + → Connectors and turn on Ansvra.

Microsoft Copilot Studio

You’ll need an agent you can edit in Copilot Studio and a read-only Ansvra access key for the project you want the agent to read. If you use GitHub Copilot in your editor, follow the Visual Studio Code steps.

  1. Open the connection form

    Open your agent and go to Tools → Add a tool → New tool → Model Context Protocol.

  2. Enter the Ansvra connection details

    Set Server name to Ansvra and Server description to Read saved Ansvra project results. Paste the connection address into Server URL. Set the authentication type to API key, select Header, enter Authorization as the header name, and select Create.

  3. Save the connection and try it

    Choose Create a new connection. In the key field, enter Bearer followed by a space and your access key. Select Add to agent, then ask the verification question in the agent’s test chat.

Grok

Grok on the web

  1. Open the custom connector form

    Go to Grok Connectors and select New Connector → Custom if available in your account. On Business and Enterprise, ask your team admin to add the connector first.

  2. Add Ansvra and check sign-in

    Paste the connection address. If Grok opens an Ansvra sign-in page, sign in, choose your project, and select Allow read access. If you can’t complete sign-in on the web, use the Grok Bot desktop steps below if you have access.

Grok Bot desktop

  1. Open the desktop connector form

    Create a read-only Ansvra access key for the project. In the desktop app, open Connect apps → Add a custom connector. Enter Ansvra as the name, select Remote HTTPS, and paste the connection address.

  2. Save and use the plugin

    In HTTP headers, set Authorization to Bearer followed by a space and your access key. Select Add plugin. In chat, type @ and select Ansvra.

Visual Studio Code

Open Visual Studio Code with GitHub Copilot signed in. If your organization manages Copilot, it may need to allow custom MCP servers.

  1. Open the Add Server menu

    Choose View → Command Palette, then search for and select MCP: Add Server.

  2. Enter your connection details

    Choose HTTP, paste the connection address, and enter ansvra as the server ID. Choose Global and select a personal Copilot configuration if prompted. Review any server trust request.

  3. Sign in from Copilot Chat

    Open GitHub Copilot Chat and ask it to list your Ansvra projects. If VS Code opens your browser, sign in to Ansvra, choose your project, and select Allow read access. Return to Copilot Chat to see the result.

Codex

  1. Install the Ansvra plugin

    Find Ansvra in the Codex plugin directory and install it if available.

  2. Sign in and approve a project

    When prompted, sign in to Ansvra, choose your project, and select Allow read access. The plugin asks for permission to renew your connection.

Verify the connection. If you use the Codex command line, add the server and sign in with the commands below. Complete the same project approval in your browser.

Codex setup
codex mcp add ansvra --url https://app.ansvra.com/mcp
codex mcp login ansvra --scopes mcp:read,offline_access
bash

Claude Code

Run the command below. In a Claude Code conversation, enter /mcp, select ansvra, and sign in to Ansvra. Select your project and choose Allow read access.

Claude Code setup
claude mcp add --transport http ansvra https://app.ansvra.com/mcp
bash

Verify the connection. After connecting, open the slash menu to browse built-in prompts. See the Prompts reference for examples.

Other MCP clients

  1. Add a remote server

    In your client’s MCP settings, add a server named Ansvra. Paste the connection address and choose Streamable HTTP if asked for the connection type.

  2. Choose how to connect

    If your client supports Ansvra’s published-identity sign-in (CIMD), sign in and approve one project. If your client supports custom request headers, you can use a read-only access key.

Connect with a read-only access key

  1. Set the key’s project access

    An account admin can open Settings → Access settings and choose Create access key. Under Project access, choose the project you want to connect. Choose All account projects if you need to switch among eligible projects in the same account. Grant only Read saved information.

  2. Add the key to your client

    Use the client’s secret storage and configure Authorization: Bearer <access key> as the request header. For Codex, set the key in the named environment variable and add the server with the command below. Keep the key out of conversations and shared configuration files.

Codex access-key setup
codex mcp add ansvra --url https://app.ansvra.com/mcp --bearer-token-env-var ANSVRA_ACCESS_KEY
bash

An access key belongs to the account that issued it. A key for one project can read that project. All account projects lets you choose among the active projects you can access in active workspaces in that account. To switch accounts, connect with a key issued by the account you want to use.

Verify the connection

Paste this question into your assistant with Ansvra enabled. Approve the request if the assistant asks whether it can use Ansvra.

Connection check
List my Ansvra projects
prompt
  1. Check the account and project

    Confirm the account and project names returned by Ansvra. If several projects appear, reply with the one you want to use.

  2. Ask about saved results

    Try Which websites were cited most in my saved Ansvra results last week? Use a period with saved results and compare the answer with the same project and dates in Ansvra. See Use Cases for more questions.

Disconnect or change projects

Open Account settings → Connections & usage → AI connections and select Disconnect for the assistant and project. For an access-key connection, revoke the key in Access settings. With All account projects, ask for the project list and choose another project in the issuing account. For sign-in or a single-project key, approve a new connection or use a read-only key that covers the other project.

Troubleshoot a connection

Why can’t I find the option to add Ansvra?

Check the setup instructions for your assistant. Custom connections can depend on the app, plan, and workspace permissions. If your organization manages the assistant, ask an admin whether custom connections are available.

Why does sign-in fail or keep asking me to connect?

Check the connection address and the sign-in option for your assistant, then reconnect and approve your project. If your client can’t use Ansvra sign-in and supports custom headers, follow the access-key steps.

Why is my project missing during sign-in?

Check that the project is active, you have access to it, and the account has an active paid plan. The approval page lists eligible projects for the signed-in user.

Why does my access key get rejected?

Check that the key is current, was issued by an active paid account, and has only Read saved information. Use the server URL without query parameters and put the key in the Authorization header.

Why is a project missing from my project list?

Check the account shown in the list and the key’s Project access in Access settings. An all-projects key still follows the key owner’s current project permissions. Archived projects and projects in archived workspaces are unavailable.

Why can the assistant read the project but not a report?

Check the dates, platforms, and saved results for that report in Ansvra. Connected website reports need saved data for the selected period. For large reports, ask for fewer dates or one page at a time.

Where are the built-in prompts?

Look in your client’s prompt picker or command menu after connecting. If your client does not display them, paste a version from the Prompts reference.

Ansvra

A clearer next step.

MEET YOUR AI GUIDE

A little clarity.
A clearer next move.

Ask about Ansvra, AI visibility, or your next step with content.

Opening chat…