Connect to the Taliesin knowledge base

How to add the knowledge base to ChatGPT, Claude, Claude Code, Codex and Mistral Le Chat, sign in for the first time, set up multi-factor authentication (MFA), and what to expect afterwards.

Connection details

Every client uses the same server and the same sign-in. Nothing is specific to your organisation: what you can read, push or review depends on the groups you have been given, not on the address you connect to.

SettingValue
Server URL (MCP)https://app.taliesin.cloud/v1.0.0/kb
Client ID6mbk1n1t6a89nqo2po2mmaofel
Client secretNone. The client is public: leave any secret field empty.
Authorization URLhttps://login.auth.taliesin.cloud/oauth2/authorize
Token URLhttps://login.auth.taliesin.cloud/oauth2/token
FlowAuthorization code with PKCE
Scopeopenid
Redirect URLs already registered https://claude.ai/api/mcp/auth_callback, https://claude.com/api/mcp/auth_callback, https://chatgpt.com/connector_platform_oauth_redirect, https://callback.mistral.ai/v1/integrations_auth/oauth2_callback, http://localhost:8765/callback (for command-line tools)

Most clients find the sign-in address on their own from the server URL. If a client asks for the fields above, use them as shown. None of these values is secret.

Your account must exist first. Accounts are created by an operator, so ask for one, and tell them which tiers you need.

First sign-in and MFA

Sign-in is the same in every client, because the sign-in page is hosted by us at login.auth.taliesin.cloud. MFA is required for everyone and cannot be skipped.

Before you start

The temporary password works for 3 days. If it has expired, ask the operator to send a new invitation.

Steps

  1. Add the connector in your client (sections below). When it opens the sign-in page, enter your email address and the temporary password.
  2. You are asked to choose a new password. It must be at least 14 characters and contain an uppercase letter, a lowercase letter, a number and a symbol. A password manager makes this easy.
  3. You are shown a QR code. In your authenticator app choose to add an account, scan the code, and enter the 6-digit code the app shows. If you cannot scan, there is a text key you can type into the app instead.
  4. You are returned to your client, signed in.

Every sign-in after that

Your email address, your password, and the current 6-digit code from the authenticator app. Codes change every 30 seconds, so enter one that has just appeared.

Lost your phone or changed apps? Ask an operator. They reset your MFA, and you set it up again at your next sign-in. Keep the QR code's text key somewhere safe if you want a backup.

Claude (claude.ai and the desktop app)

Custom connectors are available on Free (one connector), Pro, Max, Team and Enterprise plans. On Team and Enterprise, an Owner adds the connector for the organisation first and members then connect to it.

Individual plans (Free, Pro, Max)

  1. Open Customize → Connectors.
  2. Click + Add, then Add custom connector.
  3. Name: Taliesin. Server URL: https://app.taliesin.cloud/v1.0.0/kb. Click Continue.
  4. Under Authentication choose Sign in now.
  5. Under OAuth client choose Use your own OAuth client. Client ID: 6mbk1n1t6a89nqo2po2mmaofel. Leave the secret empty.
  6. Click Add, then sign in as described in First sign-in and MFA.

Team and Enterprise

  1. An Owner opens Organization settings → Connectors, clicks Add, hovers over Custom and selects Web.
  2. They enter the same name, server URL and OAuth client settings as above and click Add.
  3. Members then open Customize → Connectors, find Taliesin and click Connect.

ChatGPT

Use ChatGPT on the web. Whether you can add a custom server depends on your plan and, for workspaces, on what the workspace admin allows. ChatGPT now calls these plugins (older screens say connectors or apps).

  1. Open chatgpt.com/plugins, select the plus button and choose Add custom MCP server. On older screens: Settings → Connectors → Advanced settings, turn on Developer mode, then create a connector.
  2. Name: Taliesin. Server URL: https://app.taliesin.cloud/v1.0.0/kb.
  3. Authentication: OAuth. Enter the client ID 6mbk1n1t6a89nqo2po2mmaofel and leave the secret empty.
  4. Accept the risk warning, then create it. Install the plugin if ChatGPT asks, and sign in as described in First sign-in and MFA.

ChatGPT shows the exact redirect URL it uses. For this server it is https://chatgpt.com/connector_platform_oauth_redirect, which is already registered, so there is nothing to change on our side.

Claude Code

Claude Code runs on your own machine, so it receives the sign-in on a local port. We have registered http://localhost:8765/callback, so port 8765 must be used. If something else is using that port, free it first.

claude mcp add --transport http \
  --client-id 6mbk1n1t6a89nqo2po2mmaofel \
  --callback-port 8765 \
  taliesin https://app.taliesin.cloud/v1.0.0/kb

Do not pass --client-secret: the client has none. Then sign in, in either of two ways:

Check it with claude mcp get taliesin. To sign out: claude mcp logout taliesin. To start again, claude mcp remove taliesin and re-add it.

Use a current version of Claude Code. Claude Code version 2.1.229 sent 127.0.0.1 instead of localhost as the redirect address, which this server rejects; version 2.1.231 put it right. Non-interactive runs (claude -p) cannot complete sign-in, so sign in from an interactive session first.

Codex

Codex also uses a local port for the sign-in, so it needs the same registered address, http://localhost:8765/callback.

codex mcp add taliesin \
  --url https://app.taliesin.cloud/v1.0.0/kb \
  --oauth-client-id 6mbk1n1t6a89nqo2po2mmaofel

Then open ~/.codex/config.toml and make sure the server's entry has the callback address and scope. Do not add a secret:

[mcp_servers.taliesin]
url = "https://app.taliesin.cloud/v1.0.0/kb"
scopes = ["openid"]

[mcp_servers.taliesin.oauth]
client_id = "6mbk1n1t6a89nqo2po2mmaofel"
callback_url = "http://localhost:8765/callback"
callback_port = 8765

Sign in with codex mcp login taliesin (add --no-browser without a local browser). codex mcp list shows what is configured.

Mistral (Le Chat)

Adding a custom connector in Le Chat is an administrator action. On Free, Pro and Student plans the account owner is the administrator.

  1. Open the Connectors page (side panel → Intelligence → Connectors).
  2. Click + Add Connector and switch to the Custom MCP Connector tab.
  3. Connector name: Taliesin (no spaces or special characters). Server URL: https://app.taliesin.cloud/v1.0.0/kb.
  4. Click Connect. Le Chat detects OAuth from the server. If it shows client fields, enter the client ID 6mbk1n1t6a89nqo2po2mmaofel and scope openid, and leave the secret empty.
  5. Complete the sign-in as described in First sign-in and MFA.

Mistral's connector form has changed more than the others, and its documentation does not list the client fields. If your form behaves differently from the steps above, tell the operator what it shows.

How long sign-in lasts

WhatHow longWhat it means for you
Access token15 minutesWhat each request carries. Your client replaces it automatically; you never see this.
Refresh token30 daysHow long your client can keep signing itself in without asking you. After 30 days you sign in again with password and MFA code. It also stops working if an operator disables your account.
Temporary password3 daysThe one in your invitation email.

What you can do once connected

Signing in proves who you are. What you can do comes from the groups an operator gave you, one set per tier of the knowledge base (for example scsa-general, scsa-personal):

Signing in to an account with no group works but gives you no access, and every request is refused. A label such as tenant-… on your account only says which organisation you belong to: it grants nothing.

Troubleshooting

You seeLikely cause and what to do
"Redirect URI mismatch" or "invalid redirect"The client sent a callback address that is not registered. Command-line tools must use exactly http://localhost:8765/callback (not 127.0.0.1, not another port). For a web client, tell the operator which redirect address it shows.
"Invalid client" or "client not found"The client ID was mistyped. Use 6mbk1n1t6a89nqo2po2mmaofel exactly, with no secret.
Temporary password rejected, or "expired"It lasts 3 days and works once. Ask the operator to send a new invitation.
MFA code rejectedCodes last about 30 seconds. Wait for a fresh code. If it keeps failing, check your phone's clock is set automatically.
Lost your authenticatorAsk an operator to reset your MFA.
Signed in, but every request is refused or nothing is foundYour account has no tier groups yet, or not the one you need. Ask the operator.
The sign-in loops back to the start (Claude Code, Codex)Another program may be using port 8765. Close it and try again. Remove and re-add the server if it still loops.
You were asked to sign in again unexpectedly30 days have passed since your last sign-in, or the stored sign-in was cleared. Sign in again.