ChatGPT and OpenAI MCP Setup

Use this page when a ChatGPT workspace, OpenAI API agent, or custom connector should discover and use TextMine.

Which endpoint to use

Use https://mcp.textmine.com/mcp for public TextMine MCP setup. Use environment-specific MCP hosts only for private preview, staging validation, or dedicated deployments when TextMine explicitly issues that host.

ChatGPT connector setup

If your ChatGPT workspace supports custom MCP connectors, configure the central remote MCP endpoint:

Server URL: https://mcp.textmine.com/mcp
Authorization: Bearer tm_your_api_key

Use a caller-owned TextMine API key for authenticated execution. If the connector UI does not support bearer headers but supports custom API-key headers, use:

X-TextMine-Api-Key: tm_your_api_key

Add https://developers.textmine.com/mcp as a separate connector when the workspace should search developer docs or inspect schemas. If the connector UI does not support either bearer headers or custom headers, use the connector for documentation discovery only until a first-party OAuth flow or approved gateway is available.

If an autonomous third-party agent does not yet have a key, use Agent self-service signup. Signup is REST-first and returns an encrypted service-account key for the trusted runtime to store.

OpenAI Responses API pattern

For agents built on the OpenAI Responses API, treat TextMine as an external tool source:

1. Store the TextMine API key outside the model context.
2. Configure https://mcp.textmine.com/mcp in the agent runtime for product MCP tools.
3. Optionally configure https://developers.textmine.com/mcp for developer docs and schemas.
4. Start by reading For Agents and the relevant API Reference pages.
5. Call discovery/list operations before write operations.
6. Return TextMine resource IDs in the final answer for auditability.

Example runtime metadata:

mcp:
  textmine_docs:
    server_url: "https://developers.textmine.com/mcp"
  textmine:
    server_url: "https://mcp.textmine.com/mcp"
    authorization: "Bearer $TEXTMINE_API_KEY"

Keep tm_... keys in a secret store. Do not place raw keys in prompts, system messages, task transcripts, screenshots, or shared docs.