Connect your AI agent to Ansehn
Connect Claude, ChatGPT, Codex, Cursor or another MCP-compatible agent to one Ansehn project, and it can read the same data Copilot uses: scores, citations, buying simulations, your pages and AI crawler activity. If you allow it, it can also propose new personas and buying-simulation schedules for you to confirm. You connect either by signing in to Ansehn from the assistant, or with a project API key through the MCP server or the Capabilities API over HTTPS.
Sign in or use an API key
Both give access to the same capabilities for one project. Choose by the tool you connect.
Sign in for AI assistants with connectors: Claude (claude.ai, Claude Desktop and Cowork) and ChatGPT. You add the connector, sign in in your browser and pick the project. No key is involved, and you disconnect it in Project Settings > Connected apps. See Connect Claude or ChatGPT to Ansehn.
API key for coding agents and anything that runs without a person: Claude Code, Codex, Cursor, VS Code, scripts and scheduled jobs.
What your agent can do
Your agent sees only the project it is connected to, and only the capabilities its scopes allow.
Read your project data. Setup (monitors, prompts, personas), the AI answers for each prompt, visibility and share-of-voice scores, competitor comparisons, sentiment, domain and URL citations, buying simulations and cockpit metrics, the content log, your own pages, and AI crawler activity from server logs.
Propose new personas and schedules. With the Propose personas and schedules scope, or the matching permission you allow when you sign in, your agent can propose a new persona or a new buying-simulation schedule. You confirm each proposal on the Setup proposals page in Ansehn, and a schedule uses credits only after you confirm it. Your agent can't confirm its own proposals.
Other changes, such as editing or archiving personas, prompts, competitors or buying-simulation schedules, are available only in Copilot inside Ansehn, where a person confirms each change. See Make changes with Copilot.
MCP server or HTTP API
Both give access to the same capabilities with the same key. Choose by how your agent works.
MCP server | Capabilities API (HTTP) | |
|---|---|---|
Best for | AI assistants and coding agents such as Claude, ChatGPT, Claude Code, Codex, Cursor and VS Code | Scripts, scheduled jobs and your own applications |
Endpoint |
|
|
Discovery | Your agent lists the available tools on its own |
|
Before you start
To sign in from an assistant, any project member can connect, including Viewers. Proposing personas and schedules is offered only on projects you can edit.
You need the Owner, Admin or Agency role on the project to create an API key. Viewers cannot create keys.
A connection or key acts with the permissions of the person who created it. If that person loses access to the project, it stops working. That person also confirms its proposals.
Next steps
Connect Claude or ChatGPT to Ansehn: sign in from your assistant, no key needed.
"Make your first API call": create a key and call the API with
curl.API keys and scopes: choose the right scopes and manage keys.
"Playbooks for your AI agent": ready-to-use prompts for common tasks.