[{"data":1,"prerenderedAt":331},["ShallowReactive",2],{"navigation_docs":3,"-ai-assistants-connect":63,"-ai-assistants-connect-surround":326},[4,21,37,47],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":20},"Getting Started","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,15],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction","i-lucide-house",{"title":16,"path":17,"stem":18,"icon":19},"Campaign Configuration","\u002Fgetting-started\u002Fcampaign-configuration","1.getting-started\u002F2.campaign-configuration","i-lucide-megaphone",false,{"title":22,"icon":23,"path":24,"stem":25,"children":26,"page":20},"Embed","i-lucide-code","\u002Fembed","2.embed",[27,32],{"title":28,"path":29,"stem":30,"icon":31},"Integration Guide","\u002Fembed\u002Fguide","2.embed\u002F1.guide","i-lucide-book-open",{"title":33,"path":34,"stem":35,"icon":36},"API Reference","\u002Fembed\u002Fapi-reference","2.embed\u002F2.api-reference","i-lucide-file-code",{"title":38,"icon":39,"path":40,"stem":41,"children":42,"page":20},"External API","i-lucide-globe","\u002Fexternal-api","3.external-api",[43],{"title":44,"path":45,"stem":46,"icon":36},"Campaign Reference","\u002Fexternal-api\u002Freference","3.external-api\u002F1.reference",{"title":48,"icon":49,"path":50,"stem":51,"children":52,"page":20},"AI Assistants","i-lucide-bot","\u002Fai-assistants","4.ai-assistants",[53,58],{"title":54,"path":55,"stem":56,"icon":57},"Connect an Assistant","\u002Fai-assistants\u002Fconnect","4.ai-assistants\u002F1.connect","i-lucide-plug",{"title":59,"path":60,"stem":61,"icon":62},"What the Assistant Can Do","\u002Fai-assistants\u002Fcapabilities","4.ai-assistants\u002F2.capabilities","i-lucide-list-checks",{"id":64,"title":54,"body":65,"description":317,"extension":318,"links":319,"meta":322,"navigation":323,"path":55,"seo":324,"stem":56,"__hash__":325},"docs\u002F4.ai-assistants\u002F1.connect.md",{"type":66,"value":67,"toc":301},"minimark",[68,80,83,88,91,103,106,110,120,124,130,133,137,205,217,221,224,228,231,238,242,249,253,297],[69,70,71,72,79],"p",{},"Activoice exposes its campaign editor to AI assistants through the ",[73,74,78],"a",{"href":75,"rel":76},"https:\u002F\u002Fmodelcontextprotocol.io",[77],"nofollow","Model Context Protocol"," (MCP). Once connected, your assistant can read your campaigns, draft the briefing and the sample messages with you, add recipient groups, run the quality review, and tell you what is left before a campaign can go live.",[69,81,82],{},"The assistant acts with your own account, on the organization currently selected in your Activoice admin, and never beyond what you could do yourself.",[84,85,87],"h2",{"id":86},"one-line-setup-for-coding-agents","One-line setup for coding agents",[69,89,90],{},"If you use a coding agent such as Claude Code, Cursor, Codex or Gemini CLI, paste this sentence to it. The agent fetches our setup instructions, registers the server itself, then walks you through the sign-in:",[92,93,100],"pre",{"className":94,"code":96,"filename":97,"language":98,"meta":99},[95],"language-text","Fetch and execute the appropriate instructions to set me up for Activoice from https:\u002F\u002Fdocs.activoice.org\u002Fagent-setup\u002Fprompt.md\n","Prompt","text","",[101,102,96],"code",{"__ignoreMap":99},[69,104,105],{},"Assistants that cannot edit their own configuration, such as Claude.ai, ChatGPT or Claude Desktop, guide you through adding the connector in their own settings instead, one step at a time. The steps below cover the same ground if you prefer to do it on your own.",[84,107,109],{"id":108},"requirements","Requirements",[111,112,113,117],"ul",{},[114,115,116],"li",{},"An Activoice admin account. Every connection starts by signing in with it.",[114,118,119],{},"An assistant that supports remote MCP servers with OAuth sign-in: Claude (web and desktop apps, Claude Code), Cursor, ChatGPT in developer mode, and most recent MCP clients.",[84,121,123],{"id":122},"server-address","Server address",[92,125,128],{"className":126,"code":127,"language":98},[95],"https:\u002F\u002Fapi.activoice.org\u002Fmcp\n",[101,129,127],{"__ignoreMap":99},[69,131,132],{},"That is the only thing to configure. Discovery, sign-in and permissions are negotiated by your assistant on its own.",[84,134,136],{"id":135},"connecting","Connecting",[138,139,140,145,148,151,186,190,193,197],"steps",{},[141,142,144],"h3",{"id":143},"add-the-server-in-your-assistant","Add the server in your assistant",[69,146,147],{},"Add a remote MCP server, which some assistants call a custom connector or an integration, with the address above. No API key or client secret is needed.",[69,149,150],{},"With Claude Code, for example:",[92,152,156],{"className":153,"code":154,"language":155,"meta":99,"style":99},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","claude mcp add --transport http activoice https:\u002F\u002Fapi.activoice.org\u002Fmcp\n","bash",[101,157,158],{"__ignoreMap":99},[159,160,163,167,171,174,177,180,183],"span",{"class":161,"line":162},"line",1,[159,164,166],{"class":165},"sBMFI","claude",[159,168,170],{"class":169},"sfazB"," mcp",[159,172,173],{"class":169}," add",[159,175,176],{"class":169}," --transport",[159,178,179],{"class":169}," http",[159,181,182],{"class":169}," activoice",[159,184,185],{"class":169}," https:\u002F\u002Fapi.activoice.org\u002Fmcp\n",[141,187,189],{"id":188},"sign-in-to-your-activoice-admin","Sign in to your Activoice admin",[69,191,192],{},"Your browser opens on your Activoice admin. Sign in if you are not already, with the account you normally use.",[141,194,196],{"id":195},"allow-access","Allow access",[69,198,199,200,204],{},"A consent page then names the assistant asking for access, your account, and the organization it will work on. Choose ",[201,202,203],"strong",{},"Allow",". Your browser returns to the assistant, and the connection is ready.",[69,206,207,208,212,213,216],{},"Try it with a first request such as ",[209,210,211],"em",{},"\"List my campaigns\""," or ",[209,214,215],{},"\"Help me create a campaign to…\"",".",[84,218,220],{"id":219},"organization-scope","Organization scope",[69,222,223],{},"Every request runs on the organization currently selected in your Activoice admin, the one you see when you open it. If your assistant cannot find campaigns you expect, switch organization in the admin, then ask again. Assistants never see or change other organizations' data.",[84,225,227],{"id":226},"what-the-assistant-may-do","What the assistant may do",[69,229,230],{},"The connection grants the same rights as your account on that organization: reading and editing campaigns, recipients, custom questions and greetings. Assistants are instructed to draft, then confirm with you before saving, to confirm before deleting, and to publish a campaign only when you explicitly ask for it. A campaign cannot be published while its readiness checks report errors, whoever tries.",[69,232,233,234,237],{},"See ",[73,235,236],{"href":60},"what the assistant can do"," for the full list of tools.",[84,239,241],{"id":240},"disconnecting","Disconnecting",[69,243,244,245,248],{},"Your profile page in the Activoice admin lists the assistants connected to your account, with a ",[201,246,247],{},"Disconnect"," button for each. Disconnecting revokes the access on our side immediately: the assistant has to go through the consent page again to reconnect. Removing the server from your assistant's settings on top of that keeps things tidy, but is not required.",[84,250,252],{"id":251},"troubleshooting","Troubleshooting",[254,255,256,269],"table",{},[257,258,259],"thead",{},[260,261,262,266],"tr",{},[263,264,265],"th",{},"Symptom",[263,267,268],{},"What to check",[270,271,272,281,289],"tbody",{},[260,273,274,278],{},[275,276,277],"td",{},"The consent page never opens",[275,279,280],{},"Your assistant must be able to open a browser window. On a shared or remote machine, connect from a client running on your own computer.",[260,282,283,286],{},[275,284,285],{},"The assistant cannot find my campaigns",[275,287,288],{},"Another organization is selected in your Activoice admin. Switch to the right one and ask again.",[260,290,291,294],{},[275,292,293],{},"The assistant says it is no longer authorized",[275,295,296],{},"A connection expires after a month without use. Remove the server from your assistant and add it again.",[298,299,300],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":99,"searchDepth":302,"depth":302,"links":303},2,[304,305,306,307,313,314,315,316],{"id":86,"depth":302,"text":87},{"id":108,"depth":302,"text":109},{"id":122,"depth":302,"text":123},{"id":135,"depth":302,"text":136,"children":308},[309,311,312],{"id":143,"depth":310,"text":144},3,{"id":188,"depth":310,"text":189},{"id":195,"depth":310,"text":196},{"id":219,"depth":302,"text":220},{"id":226,"depth":302,"text":227},{"id":240,"depth":302,"text":241},{"id":251,"depth":302,"text":252},"Build and maintain campaigns from Claude, Cursor or any MCP-compatible AI assistant","md",[320],{"label":321,"icon":62,"to":60},"What the assistant can do",{},{"icon":57},{"title":54,"description":317},"ykx-HkT6eT47lKXvUK8ZquuQrLgkIwKeAy64Kxoy7Nc",[327,329],{"title":44,"path":45,"stem":46,"description":328,"icon":36,"children":-1},"Read a campaign's public data from your own website",{"title":59,"path":60,"stem":61,"description":330,"icon":62,"children":-1},"The campaign editor steps and the tools your assistant can use",1790170885583]