On this page
Connect Ansvra to your AI assistant
Choose your assistant, connect a project, and ask your first question about saved Ansvra results.
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.
https://app.ansvra.com/mcpCopy 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
Add Ansvra from Plugins on the web.
ClaudeAdd a custom connector on the web or desktop.
Microsoft Copilot StudioAdd Ansvra to an agent you can edit.
GrokUse Grok’s web connectors or the Grok Bot desktop app.
Visual Studio CodeUse Ansvra in GitHub Copilot Chat.
CodexInstall the Ansvra plugin or connect from the command line.
Claude CodeConnect from the command line.
Other MCP clientsFind connection details for Cursor and other compatible tools.
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.
Add a custom server
Open ChatGPT Plugins, select +, then Add custom MCP server. Name it Ansvra and paste the connection address into Server URL.
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.
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.
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.
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.
Enable Ansvra for your chat
In a new chat, select + → Connectors and turn on Ansvra.
See Claude’s custom connector guide for account requirements. Verify the connection.
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.
Open the connection form
Open your agent and go to Tools → Add a tool → New tool → Model Context Protocol.
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
Authorizationas the header name, and select Create.Save the connection and try it
Choose Create a new connection. In the key field, enter
Bearerfollowed by a space and your access key. Select Add to agent, then ask the verification question in the agent’s test chat.
See Microsoft’s Copilot Studio guide for the connection wizard. Verify the connection.
Grok
Grok on the web
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.
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
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.
Save and use the plugin
In HTTP headers, set
AuthorizationtoBearerfollowed by a space and your access key. Select Add plugin. In chat, type@and select Ansvra.
See the guides for Grok web connectors and Grok Bot desktop. Verify the connection.
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.
Open the Add Server menu
Choose View → Command Palette, then search for and select MCP: Add Server.
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.
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.
See Microsoft’s VS Code guide for the setup menu. Verify the connection.
Codex
Install the Ansvra plugin
Find Ansvra in the Codex plugin directory and install it if available.
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 mcp add ansvra --url https://app.ansvra.com/mcp
codex mcp login ansvra --scopes mcp:read,offline_accessClaude 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 mcp add --transport http ansvra https://app.ansvra.com/mcpVerify the connection. After connecting, open the slash menu to browse built-in prompts. See the Prompts reference for examples.
Other MCP clients
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.
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.
For access-key setup, see Cursor’s remote server configuration or GitHub Copilot CLI’s MCP setup. Verify the connection.
Connect with a read-only access key
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.
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 mcp add ansvra --url https://app.ansvra.com/mcp --bearer-token-env-var ANSVRA_ACCESS_KEYAn 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.
List my Ansvra projectsCheck 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.
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.