Guides3 min read
ChatGPT
Add OpsKnight to ChatGPT as a custom MCP server plugin, including private installations through OpenAI Secure MCP Tunnel.
Status: Expected. These steps follow OpenAI's documentation; no end-to-end run of ChatGPT against OpsKnight is recorded. ChatGPT's OAuth profile (redirect https://chatgpt.com/connector_platform_oauth_redirect, search/fetch shape) passed the emulated client matrix run.
Vendor documentation (fetched 12 November 2026): Building MCP servers for ChatGPT and API integrations and Connect from ChatGPT.
Before you begin
- An administrator has turned on AI assistant access in Settings → Integrations & ChatOps → MCP (AI Assistants) (see MCP setup). Copy the MCP server URL from the Connect tab on that page.
- ChatGPT connects from OpenAI's cloud. OpsKnight must be reachable over public HTTPS with a trusted certificate, or through OpenAI Secure MCP Tunnel for a private installation.
- Plan and workspace rules change often and OpenAI's help center could not be fetched for this guide. Which plans may add custom MCP servers, and whether write tools are allowed on yours, is decided by OpenAI and your workspace administrator; check the vendor pages above.
Connect with OAuth
- Open
chatgpt.com/plugins, select +, then Add custom MCP server. - Name it
OpsKnight. Under the connection, pastehttps://ops.your-company.com/mcp, or choose your Secure MCP Tunnel. - Choose OAuth. ChatGPT identifies itself with a metadata document or registers itself, which OpsKnight's Automatic connections accepts. If automatic connections are off, an administrator registers a manual client with redirect URI
https://chatgpt.com/connector_platform_oauth_redirectand you enter its client ID. - Accept the warning, select Create as a plugin, install it, then sign in to OpsKnight and approve.
Personal access token
Not available: OpenAI's pages document OAuth and no-authentication only, with no custom request headers. Use OAuth.
Known limits
- ChatGPT treats every tool without
readOnlyHintas a write action and asks for confirmation by default. OpsKnight marks its read tools read-only. - Company knowledge and deep research call only
searchandfetch. OpsKnight serves both (on by default under Exposed capabilities). - ChatGPT reads only the first 512 characters of server instructions reliably; OpsKnight's instructions fit.
- The tool list is a snapshot: after an administrator changes exposed capabilities, open the connection, select Refresh, and start a new conversation. In a workspace, an administrator may need to republish it.
- OpenAI documents no tool-count or result-size cap. OpsKnight lists at most 54 tools.
Troubleshooting
- Expand a tool call in the conversation to see the request and response JSON, including OpsKnight's error code.
- Check the endpoint from outside with
npm run mcp:doctor -- https://ops.your-company.com/mcp, or with MCP Inspector (npx @modelcontextprotocol/inspector@latest). - With a tunnel, check the tunnel client's status first.
- If ChatGPT asks you to sign in again every few days, its stored authorization expired; reconnect.
Last updated for v2.2.0
Edit this page on GitHub