[{"data":1,"prerenderedAt":1042},["ShallowReactive",2],{"documentation-\u002Fdocumentation\u002Fmcp":3},{"id":4,"title":5,"body":6,"description":1032,"extension":1033,"meta":1034,"navigation":1035,"ogImage":1036,"path":1037,"seo":1038,"sitemap":1039,"stem":1040,"__hash__":1041},"content\u002Fdocumentation\u002Fmcp.md","Chatisto MCP server for Claude and ChatGPT",{"type":7,"value":8,"toc":1010},"minimark",[9,13,36,45,50,124,132,136,141,175,178,182,219,234,237,241,250,254,260,264,267,275,279,294,298,301,378,382,485,489,527,531,538,727,730,848,864,868,901,905,939,950,954,997,1001,1006],[10,11,12],"p",{},"The Chatisto MCP server lets you run your website's customer support from an AI assistant. Connect it once, then ask in plain language:",[14,15,16,27,30,33],"ul",{},[17,18,19,20,26],"li",{},"\"Add Chatisto to my website ",[21,22,23],"a",{"href":23,"rel":24},"https:\u002F\u002Fexample.com",[25],"nofollow"," and install the chat widget.\"",[17,28,29],{},"\"Summarize today's open support conversations.\"",[17,31,32],{},"\"Which customers asked about refunds this week?\"",[17,34,35],{},"\"Build a chatbot flow that greets visitors and offers Pricing and Talk to a human.\"",[10,37,38,39,44],{},"It uses the ",[21,40,43],{"href":41,"rel":42},"https:\u002F\u002Fmodelcontextprotocol.io",[25],"Model Context Protocol",", so it works with any assistant that supports remote MCP servers with OAuth.",[46,47,49],"h2",{"id":48},"server-details","Server details",[51,52,53,66],"table",{},[54,55,56],"thead",{},[57,58,59,63],"tr",{},[60,61,62],"th",{},"Setting",[60,64,65],{},"Value",[67,68,69,84,94,104,114],"tbody",{},[57,70,71,78],{},[72,73,74],"td",{},[75,76,77],"strong",{},"Server URL",[72,79,80],{},[81,82,83],"code",{},"https:\u002F\u002Ffresh-api.chatisto.com\u002Fmcp",[57,85,86,91],{},[72,87,88],{},[75,89,90],{},"Transport",[72,92,93],{},"Streamable HTTP",[57,95,96,101],{},[72,97,98],{},[75,99,100],{},"Authentication",[72,102,103],{},"OAuth 2.1 with PKCE. You sign in with your Chatisto account; no API keys.",[57,105,106,111],{},[72,107,108],{},[75,109,110],{},"Rate limit",[72,112,113],{},"120 requests per minute per user",[57,115,116,121],{},[72,117,118],{},[75,119,120],{},"Cost",[72,122,123],{},"No extra charge. Works on every Chatisto plan.",[10,125,126,127,131],{},"You need a Chatisto account. If you don't have one, ",[21,128,130],{"href":129},"\u002Fauth\u002Fcreate-account","create one for free"," first.",[46,133,135],{"id":134},"connect","Connect",[137,138,140],"h3",{"id":139},"claude-web-desktop-and-mobile","Claude (web, desktop and mobile)",[142,143,144,151,157,166],"ol",{},[17,145,146,147,150],{},"In Claude, open ",[75,148,149],{},"Settings → Connectors",".",[17,152,153,154,150],{},"Click ",[75,155,156],{},"Add custom connector",[17,158,159,160,163,164],{},"Name it ",[81,161,162],{},"Chatisto"," and paste the server URL: ",[81,165,83],{},[17,167,153,168,171,172,174],{},[75,169,170],{},"Add",", then ",[75,173,135],{},". Sign in to Chatisto in the window that opens and approve access.",[10,176,177],{},"The connector syncs across Claude on the web, Claude Desktop and the Claude mobile apps. On Team and Enterprise plans, an organization owner may need to add the connector first.",[137,179,181],{"id":180},"claude-code","Claude Code",[183,184,189],"pre",{"className":185,"code":186,"language":187,"meta":188,"style":188},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","claude mcp add --transport http chatisto https:\u002F\u002Ffresh-api.chatisto.com\u002Fmcp\n","bash","",[81,190,191],{"__ignoreMap":188},[192,193,196,200,204,207,210,213,216],"span",{"class":194,"line":195},"line",1,[192,197,199],{"class":198},"sBMFI","claude",[192,201,203],{"class":202},"sfazB"," mcp",[192,205,206],{"class":202}," add",[192,208,209],{"class":202}," --transport",[192,211,212],{"class":202}," http",[192,214,215],{"class":202}," chatisto",[192,217,218],{"class":202}," https:\u002F\u002Ffresh-api.chatisto.com\u002Fmcp\n",[10,220,221,222,225,226,229,230,233],{},"Then run ",[81,223,224],{},"\u002Fmcp"," inside Claude Code, select ",[75,227,228],{},"chatisto"," and choose ",[75,231,232],{},"Authenticate",". Your browser opens to sign in to Chatisto.",[10,235,236],{},"Claude Code is the fastest way to add Chatisto to a website you're building: it can create the workspace and paste the widget code into your layout file for you.",[137,238,240],{"id":239},"chatgpt","ChatGPT",[10,242,243,244,246,247,249],{},"Search for ",[75,245,162],{}," in the ChatGPT apps directory and click ",[75,248,135],{},". If it isn't listed for your account yet, turn on developer mode in ChatGPT's settings and add the server URL above as a custom connector.",[137,251,253],{"id":252},"other-mcp-clients","Other MCP clients",[10,255,256,257,150],{},"Any client that supports remote Streamable HTTP servers with OAuth dynamic client registration can connect using the server URL. OAuth metadata is published at ",[81,258,259],{},"https:\u002F\u002Ffresh-api.chatisto.com\u002F.well-known\u002Foauth-protected-resource\u002Fmcp",[46,261,263],{"id":262},"set-it-up-with-one-prompt","Set it up with one prompt",[10,265,266],{},"Paste this into your assistant. It connects the server if needed, creates your workspace and installs the widget:",[183,268,273],{"className":269,"code":271,"language":272,"meta":188},[270],"language-text","Set up Chatisto (AI chatbot + live chat) on my website.\n\n1. Connect the Chatisto MCP server if it isn't connected yet:\n   URL: https:\u002F\u002Ffresh-api.chatisto.com\u002Fmcp (remote, streamable HTTP, sign in with OAuth)\n   - Claude Code: claude mcp add --transport http chatisto https:\u002F\u002Ffresh-api.chatisto.com\u002Fmcp\n   - Claude or ChatGPT: add it as a custom connector, then sign in to Chatisto.\n2. Ask me for my website address, then call add_chatisto_to_website.\n3. Install the returned chat widget code: if you can edit my site's code, add it to the shared layout right before \u003C\u002Fbody>. Otherwise give me the steps for my platform (get_widget_install_code).\n4. Call get_setup_status and tell me what's live and what's left.\n\nDocs: https:\u002F\u002Fchatisto.com\u002Fdocumentation\u002Fmcp\n","text",[81,274,271],{"__ignoreMap":188},[46,276,278],{"id":277},"what-it-can-do","What it can do",[10,280,281,284,285,288,289,293],{},[75,282,283],{},"Read"," tools only look at your data. ",[75,286,287],{},"Write"," tools change something, and the ones marked ",[290,291,292],"em",{},"reaches customers"," are visible to your website visitors right away. Your assistant should ask you to confirm before using those.",[137,295,297],{"id":296},"workspaces-and-setup","Workspaces and setup",[10,299,300],{},"A workspace is one website or brand in Chatisto. Tools use the workspace that's active in the Chatisto app, unless you name another one.",[51,302,303,316],{},[54,304,305],{},[57,306,307,310,313],{},[60,308,309],{},"Tool",[60,311,312],{},"Type",[60,314,315],{},"What it does",[67,317,318,330,342,354,366],{},[57,319,320,325,327],{},[72,321,322],{},[81,323,324],{},"list_workspaces",[72,326,283],{},[72,328,329],{},"Lists the workspaces you can access.",[57,331,332,337,339],{},[72,333,334],{},[81,335,336],{},"add_chatisto_to_website",[72,338,287],{},[72,340,341],{},"Creates a workspace for a website, puts an AI chatbot live, starts learning from the website's pages and returns the widget code.",[57,343,344,349,351],{},[72,345,346],{},[81,347,348],{},"get_widget_install_code",[72,350,283],{},[72,352,353],{},"Widget code and steps for HTML, WordPress, Shopify, Next.js, React or Nuxt.",[57,355,356,361,363],{},[72,357,358],{},[81,359,360],{},"get_setup_status",[72,362,283],{},[72,364,365],{},"Whether the chatbot is live, which websites the knowledge base learns from and when they were last crawled, and whether visitors have started chatting (which confirms the widget is installed).",[57,367,368,373,375],{},[72,369,370],{},[81,371,372],{},"refresh_knowledge_base",[72,374,287],{},[72,376,377],{},"Re-crawls the workspace's websites now and sets the automatic re-crawl schedule (off, weekly or monthly).",[137,379,381],{"id":380},"inbox","Inbox",[51,383,384,394],{},[54,385,386],{},[57,387,388,390,392],{},[60,389,309],{},[60,391,312],{},[60,393,315],{},[67,395,396,408,420,432,444,459,471],{},[57,397,398,403,405],{},[72,399,400],{},[81,401,402],{},"list_conversations",[72,404,283],{},[72,406,407],{},"Recent conversations. Filter by open\u002Fclosed, assigned to me or unassigned, chat or email, or search text.",[57,409,410,415,417],{},[72,411,412],{},[81,413,414],{},"get_conversation",[72,416,283],{},[72,418,419],{},"One conversation with up to 100 latest messages, showing whether the customer, an operator or the chatbot sent each one.",[57,421,422,427,429],{},[72,423,424],{},[81,425,426],{},"get_inbox_stats",[72,428,283],{},[72,430,431],{},"Conversations, customers, messages, response times and top operators for 24h, 7d, 1m, 1y or all time, compared with the previous period. Plus how many conversations are open and unassigned right now.",[57,433,434,439,441],{},[72,435,436],{},[81,437,438],{},"search_knowledge_base",[72,440,283],{},[72,442,443],{},"Searches the content your AI chatbot answers from. Useful to draft accurate replies.",[57,445,446,451,456],{},[72,447,448],{},[81,449,450],{},"reply_to_conversation",[72,452,453,454],{},"Write, ",[290,455,292],{},[72,457,458],{},"Sends a message in an open web chat as you. If the chatbot was handling the chat, it switches to live chat.",[57,460,461,466,468],{},[72,462,463],{},[81,464,465],{},"assign_conversation",[72,467,287],{},[72,469,470],{},"Assigns a conversation to you or a teammate (by email).",[57,472,473,478,482],{},[72,474,475],{},[81,476,477],{},"close_conversation",[72,479,453,480],{},[290,481,292],{},[72,483,484],{},"Closes a conversation and sends your end-of-conversation message.",[137,486,488],{"id":487},"customers","Customers",[51,490,491,501],{},[54,492,493],{},[57,494,495,497,499],{},[60,496,309],{},[60,498,312],{},[60,500,315],{},[67,502,503,515],{},[57,504,505,510,512],{},[72,506,507],{},[81,508,509],{},"search_customers",[72,511,283],{},[72,513,514],{},"Finds customers by name, email or ID.",[57,516,517,522,524],{},[72,518,519],{},[81,520,521],{},"get_customer",[72,523,283],{},[72,525,526],{},"Contact details, information collected by forms and the chatbot, and recent conversations.",[137,528,530],{"id":529},"chatbot-scenarios","Chatbot scenarios",[10,532,533,534,150],{},"A scenario is the flow your chatbot follows: messages, questions, button menus, AI answers and handoffs to a human. See ",[21,535,537],{"href":536},"\u002Fdocumentation\u002Fscenarios","Scenarios",[51,539,540,550],{},[54,541,542],{},[57,543,544,546,548],{},[60,545,309],{},[60,547,312],{},[60,549,315],{},[67,551,552,564,580,592,604,617,648,660,672,684,698,715],{},[57,553,554,559,561],{},[72,555,556],{},[81,557,558],{},"list_scenarios",[72,560,283],{},[72,562,563],{},"Lists scenarios and shows which one is live.",[57,565,566,571,573],{},[72,567,568],{},[81,569,570],{},"get_scenario",[72,572,283],{},[72,574,575,576,579],{},"All steps of a scenario in order, plus ",[75,577,578],{},"warnings",": buttons that lead nowhere, steps that can't be reached and AI steps visitors can't leave.",[57,581,582,587,589],{},[72,583,584],{},[81,585,586],{},"create_scenario",[72,588,287],{},[72,590,591],{},"Creates a new scenario. It stays offline until you activate it.",[57,593,594,599,601],{},[72,595,596],{},[81,597,598],{},"rename_scenario",[72,600,287],{},[72,602,603],{},"Renames a scenario.",[57,605,606,611,614],{},[72,607,608],{},[81,609,610],{},"delete_scenario",[72,612,613],{},"Write, destructive",[72,615,616],{},"Deletes a scenario that isn't live, with all its steps.",[57,618,619,624,626],{},[72,620,621],{},[81,622,623],{},"add_scenario_step",[72,625,287],{},[72,627,628,629,631,632,631,635,631,638,631,641,644,645,150],{},"Adds a step: ",[81,630,272],{},", ",[81,633,634],{},"question",[81,636,637],{},"buttons",[81,639,640],{},"handoff",[81,642,643],{},"ai_agent"," or ",[81,646,647],{},"condition",[57,649,650,655,657],{},[72,651,652],{},[81,653,654],{},"update_scenario_step",[72,656,287],{},[72,658,659],{},"Edits a step's message, buttons, next step, question format, image, translations, branches or AI tools.",[57,661,662,667,669],{},[72,663,664],{},[81,665,666],{},"delete_scenario_step",[72,668,613],{},[72,670,671],{},"Deletes a step (and optionally the steps under it).",[57,673,674,679,681],{},[72,675,676],{},[81,677,678],{},"set_scenario_start_step",[72,680,287],{},[72,682,683],{},"Chooses the step the chat starts with.",[57,685,686,691,695],{},[72,687,688],{},[81,689,690],{},"activate_scenario",[72,692,453,693],{},[290,694,292],{},[72,696,697],{},"Makes a scenario the live (default) chatbot on your website chat, replacing the current one.",[57,699,700,705,709],{},[72,701,702],{},[81,703,704],{},"set_scenario_page_rules",[72,706,453,707],{},[290,708,292],{},[72,710,711,712,150],{},"Starts a scenario instead of the live one on matching pages, e.g. ",[81,713,714],{},"\u002Fpricing*",[57,716,717,722,724],{},[72,718,719],{},[81,720,721],{},"set_scenario_languages",[72,723,287],{},[72,725,726],{},"Sets the scenario's primary language and the languages its steps are translated into.",[10,728,729],{},"What steps can do through the MCP server:",[14,731,732,742,778,788,802,822,838],{},[17,733,734,737,738,741],{},[75,735,736],{},"Buttons"," lead to a step, or open a link with ",[81,739,740],{},"url"," (signup, pricing, a booking page).",[17,743,744,747,748,751,752,631,754,631,757,631,760,644,763,765,766,769,770,773,774,777],{},[75,745,746],{},"Questions"," take a ",[81,749,750],{},"question_format"," (",[81,753,272],{},[81,755,756],{},"email",[81,758,759],{},"phone",[81,761,762],{},"number",[81,764,740],{},") and are asked again until the answer matches. ",[81,767,768],{},"save_to_property"," saves the answer to a contact property, such as ",[81,771,772],{},"business_type",". ",[81,775,776],{},"invalid_message"," sets what the bot says before asking again.",[17,779,780,783,784,787],{},[75,781,782],{},"AI steps"," can have buttons shown under every answer, such as \"Back to menu\", and ",[81,785,786],{},"ai_tools.handoff"," lets the AI hand the chat to a human.",[17,789,790,793,794,797,798,801],{},[75,791,792],{},"Condition steps"," route by ",[81,795,796],{},"branches"," (rules on operator availability, business hours, contact properties, earlier answers, page URL, channel or language) with an ",[81,799,800],{},"else_step_id"," fallback. They send nothing.",[17,803,804,807,808,811,812,631,815,818,819,150],{},[75,805,806],{},"Images:"," text, question, buttons and handoff steps can show ",[81,809,810],{},"image_url"," (https) with ",[81,813,814],{},"image_alt",[81,816,817],{},"image_caption"," and ",[81,820,821],{},"image_link_url",[17,823,824,827,828,830,831,834,835,837],{},[75,825,826],{},"Translations:"," after ",[81,829,721],{},", give each step ",[81,832,833],{},"translations"," (message, button labels, invalid message, image texts per language). ",[81,836,570],{}," warns about missing ones.",[17,839,840,843,844,847],{},[75,841,842],{},"Any step"," can wait ",[81,845,846],{},"delay_seconds"," before it's sent.",[10,849,850,851,854,855,857,858,860,861,150],{},"Edits to the ",[75,852,853],{},"live"," scenario reach visitors immediately. To be safe, build a new scenario, check ",[81,856,570],{}," for warnings, then activate it. Setting the default scenario for the ",[75,859,756],{}," channel isn't supported yet; do it in ",[75,862,863],{},"Scenario → Email",[46,865,867],{"id":866},"permissions","Permissions",[14,869,870,877,887,893],{},[17,871,872,873,876],{},"The assistant acts ",[75,874,875],{},"as you",". It can only see the workspaces your Chatisto account belongs to, and replies are sent under your name.",[17,878,879,882,883,886],{},[75,880,881],{},"Changing chatbot scenarios"," (creating, editing, activating) requires the ",[75,884,885],{},"owner"," role in that workspace. Operators can read and answer conversations but not change the chatbot.",[17,888,889,890,892],{},"Replying to ",[75,891,756],{}," conversations isn't supported yet. You can read them, assign them and close them.",[17,894,895,896,818,898,900],{},"Nothing can be bulk-deleted. The only destructive tools are ",[81,897,666],{},[81,899,610],{},", and the live scenario can't be deleted.",[46,902,904],{"id":903},"data-and-privacy","Data and privacy",[14,906,907,913,919,925],{},[17,908,909,912],{},[75,910,911],{},"What the assistant can access:"," your workspaces' conversations, customer profiles, knowledge base content and chatbot scenarios. Only what the tools above return.",[17,914,915,918],{},[75,916,917],{},"Where it goes:"," tool results are sent to the AI assistant you connected (e.g. Anthropic for Claude, OpenAI for ChatGPT) and handled under that provider's terms. Chatisto only receives the tool calls the assistant makes, not your conversation with the assistant.",[17,920,921,924],{},[75,922,923],{},"Sign-in:"," OAuth, so the assistant never sees your Chatisto password. Access tokens are valid for 1 day and refresh tokens for 90 days.",[17,926,927,930,931,934,935,150],{},[75,928,929],{},"Disconnect:"," remove the Chatisto connector in your assistant's settings (in Claude Code: ",[81,932,933],{},"claude mcp remove chatisto","). To revoke all issued tokens on Chatisto's side, email ",[21,936,938],{"href":937},"mailto:info@chatisto.com","info@chatisto.com",[10,940,941,942,818,946,150],{},"See our ",[21,943,945],{"href":944},"\u002Fprivacy-policy","Privacy Policy",[21,947,949],{"href":948},"\u002Fterms-of-service","Terms of Service",[46,951,953],{"id":952},"troubleshooting","Troubleshooting",[14,955,956,970,976,985,991],{},[17,957,958,961,962,964,965,964,967,969],{},[75,959,960],{},"\"Sign in to Chatisto to use this tool.\""," Your session expired or wasn't completed. Reconnect the connector (in Claude Code: ",[81,963,224],{}," → ",[75,966,228],{},[75,968,232],{},").",[17,971,972,975],{},[75,973,974],{},"\"Only owners of the … workspace can change chatbot scenarios.\""," Ask a workspace owner to make the change or to give you the owner role.",[17,977,978,981,982,984],{},[75,979,980],{},"\"Conversation not found in your workspaces.\""," The conversation belongs to a workspace you're not a member of, or the ID is from another workspace. Ask the assistant to run ",[81,983,324],{}," and pick the right one.",[17,986,987,990],{},[75,988,989],{},"The assistant uses the wrong website."," Say which one, e.g. \"use the Acme Store workspace\". Tools default to the workspace last active in the Chatisto app.",[17,992,993,996],{},[75,994,995],{},"Too many requests."," The limit is 120 requests per minute. Wait a minute and try again.",[46,998,1000],{"id":999},"support","Support",[10,1002,1003,1004,150],{},"Questions or problems with the MCP server: ",[21,1005,938],{"href":937},[1007,1008,1009],"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":188,"searchDepth":1011,"depth":1011,"links":1012},2,[1013,1014,1021,1022,1028,1029,1030,1031],{"id":48,"depth":1011,"text":49},{"id":134,"depth":1011,"text":135,"children":1015},[1016,1018,1019,1020],{"id":139,"depth":1017,"text":140},3,{"id":180,"depth":1017,"text":181},{"id":239,"depth":1017,"text":240},{"id":252,"depth":1017,"text":253},{"id":262,"depth":1011,"text":263},{"id":277,"depth":1011,"text":278,"children":1023},[1024,1025,1026,1027],{"id":296,"depth":1017,"text":297},{"id":380,"depth":1017,"text":381},{"id":487,"depth":1017,"text":488},{"id":529,"depth":1017,"text":530},{"id":866,"depth":1011,"text":867},{"id":903,"depth":1011,"text":904},{"id":952,"depth":1011,"text":953},{"id":999,"depth":1011,"text":1000},"Connect Claude, Claude Code or ChatGPT to Chatisto. Set up support on a website, answer customers from your inbox, look up customers and build chatbot flows from your AI assistant.","md",{},true,null,"\u002Fdocumentation\u002Fmcp",{"title":5,"description":1032},{"loc":1037},"documentation\u002Fmcp","-zrrH7k2sp_cT7uO7OqDpID8GNeORCwCqtxGBdq-hv4",1794660395858]