knowmindknowmind
DokumentationQuickstartAnbindungReferenzFehlerbehebung
DEEN
knowmindknowmind
DocumentationQuickstartIntegrationsReferenceTroubleshooting
DEEN

Integration

ChatGPT

This guide registers knowmind as a custom connector in ChatGPT. Available on ChatGPT Plus, Pro, Team and Enterprise. Setup takes around three minutes.

Audience
Private and business ChatGPT users. On Team and Enterprise plans the workspace admin may need to approve custom connectors or may have restricted them.

Prerequisites

  • ChatGPT account on Plus, Pro, Team or Enterprise
  • On Team and Enterprise, approval from the workspace administrator if connectors are gated
  • knowmind account on any plan
  • For the token option: API token of the form kmt_…

Steps

  1. 1

    Open the connector dialog

    In ChatGPT click your profile at the bottom left, then Settings → Connectors. In newer ChatGPT versions the area may be labelled Settings → Connectors or Developer Mode → Custom Connectors, depending on plan. Click New custom connector.

    Outcome: The connector dialog is visible.

  2. 2

    Configure the integration

    Option A — OAuth (recommended where your ChatGPT plan supports it):

    text
    Name:       knowmind
URL:        https://knowmind.de/api/mcp/v1
Auth type:  OAuth

    ChatGPT reads the OAuth metadata from the MCP endpoint and registers itself automatically. You are redirected to sign in to knowmind, you confirm access, and you return to ChatGPT.

    Option B — bearer token:

    text
    Name:       knowmind
URL:        https://knowmind.de/api/mcp/v1
Auth type:  Bearer
Token:      kmt_… (from knowmind dashboard → API Tokens)
  3. 3

    Save and activate the connector

    Click Add. ChatGPT tests the endpoint with tools/list, shows the ten knowmind tools and asks for confirmation.

    Outcome: knowmind is visible in the connector list and active. In new chats the tools appear in the side toolbar.

  4. 4

    Smoke test

    Start a new chat and ask a question about your knowledge content, for example: "What open items remain on the Müller GmbH contract?" ChatGPT recognises the need for a tool call and runs knowmind.recall.

    Outcome: ChatGPT answers based on content from your knowmind corpus. The tool area shows the call with parameters and result.

Verify the result

The integration is correct when all three conditions hold:

  • knowmind shows up in the connector list as active.
  • The ten knowmind tools appear in a new chat.
  • A knowmind.recall call returns hits and is traceable in the knowmind dashboard under Recent activity (where the audit log is unlocked on your plan).

Troubleshooting

Error messageCauseResolution
Connector area not visiblePlan does not support custom connectors, or the workspace admin has gated it.Connectors are available on ChatGPT Plus, Pro, Team and Enterprise. On Team / Enterprise, ask your workspace admin if needed.
Connection fails with 'Endpoint not reachable'Network issue or URL typo.Check the URL exactly: https://knowmind.de/api/mcp/v1. Test reachability at https://knowmind.de/api/health.
Tools see knowmind but do not answer from the corpusChatGPT does not recognise the recall need on its own.Ask explicitly: "Look up … in knowmind". Optionally store a Memory Pack as a custom instruction in your ChatGPT profile.
OAuth window stays emptyPopup blocker or browser extension blocking the redirect.Allow popups for knowmind.de and chatgpt.com, then add the connector again.

Related