Connect a client
Add the Taizen MCP server to Claude Code, Claude Desktop, or Cursor.
You need the MCP server URL for your environment and a Taizen account. Authentication is OAuth 2.0 with PKCE — you sign in in a browser window; the client never handles your password.
Add the server from the CLI:
claude mcp add --transport sse taizen <MCP_SERVER_URL>/sseThen, in a session, authenticate:
/mcpPick taizen and complete the OAuth flow in the browser window that opens. The tools appear as
mcp__taizen__* once connected.
Check it works:
Use search_knowledge to find what customers said about onboarding.Ask your Taizen admin for the MCP server URL for your environment. It differs between regions, and your data stays in your own region.
Verify the connection
Three quick checks, in order:
list_integrations— proves auth works and shows what your workspace has connected.search_knowledgewith a term you know appears in your calls — proves the vector index is reachable.run_agentwith a small question — proves the agent service is reachable.
If step 1 works and step 2 doesn't, it's an indexing question, not an auth one.
Conversation continuity
run_agent continues your current conversation for that project, so consecutive calls build on each other the
way a thread does. Call new_conversation to start clean — worth doing when you switch topics, since a stale
context makes answers drift.
Troubleshooting
| Symptom | Cause |
|---|---|
| OAuth window opens and closes with no result | Popup blocked, or the redirect was interrupted. Retry and complete the flow in one go |
| Tools listed but every call fails | Token expired — re-authenticate (/mcp in Claude Code) |
search_knowledge returns nothing | Your workspace may have nothing indexed yet, or the query is too specific. Try a broader term |
| Client can't find the server | Wrong URL, or the /sse path is missing |