The Spekit MCP links your governed Spekit content to the AI tool you already use, so you can search, cite, and create content without leaving the conversation. It works with any AI tool that supports a custom connector by URL and dynamic registration, including Claude, ChatGPT, Gemini, Codex, and Gong.
Everything you do through the connector runs as you, scoped to your existing Spekit role. It does not give you any access you did not already have in the Spekit web app.
📌 Quick-Jump Topics
1. What is the Spekit MCP Connector?
Your team already spends the day inside an AI assistant. Until now, that assistant had no view into what Spekit knows, so reps left their flow to find an approved answer, and anything drafted in a conversation stayed in that conversation.
The connector closes that gap. The same knowledge, the same permissions, and the same governance Spekit already provides are available in the AI tool your team is already using.
One Connector, Every AI Tool
You connect once, with one server URL, and the same connector works across every AI tool that supports custom connectors. You do not need a separate integration project per platform.
2. What You Can Do
The connector gives your AI tool a set of read tools and write tools. Every tool runs as you, scoped to your existing Spekit role.
🔎 Find and Use Content (Read Tools)
Get approved answers and browse your library without switching apps.
| Tool | What it does |
|---|---|
| Get authenticated user | Returns your identity so the calls that follow are scoped to your account. |
| List topics | Returns the topics you can access, with their direct subtopics. |
| Get topic | Returns a topic's parents and subtopics, so you can go deeper. |
| Search content | Keyword search across all Speks you can access. |
| List topic content | Returns the Speks filed under a specific topic. |
| Get content | Returns a single Spek's full body and its topic assignments. |
| Get asset content | Returns the text contents of a file asset by id. |
| Get content style guide | Returns Spekit's design system rules, used before authoring. |
| List content templates | Returns the content templates available to your company. |
| Get content template | Returns a template's body and fill instructions. |
| List companies | Returns companies visible to you. You can filter by name. |
| List deal rooms | Returns deal rooms visible to you. You can filter by name. |
✍️ Create and Manage Content (Write Tools)
Draft and update governed content from a conversation, with no copy and paste back into Spekit.
| Tool | What it does |
|---|---|
| Create topic | Creates a topic, optionally as a subtopic of an existing one. |
| Create content | Creates a new Spek, filed under one or more topics. |
| Create content from template | Creates a new Spek from one of your company's templates. |
| Update content | Updates the title, body, or topic assignment of an existing Spek. |
| Create company | Creates a new company. |
| Create deal room | Creates a deal room under an existing company. |
| Create deal room content | Creates a Spek scoped to a specific deal room. |
Working Within Your Permissions
Every call runs as you. What you can see and do through the connector matches what your Spekit account can already see and do. This is enforced at the backend, not just in the connector. A viewer-only user cannot create or change content through an AI tool, even by asking.
One request can run several steps. For example, a request to build a launch content set can read your approved messaging, then draft and create each piece in turn, in order, from that one request.
3. Who Can Use It
Access depends on your AI tool, and in some tools your plan or admin role. In all cases you sign in with your existing Spekit login. The details for each tool are in the Setup section below.
- Claude: Team and Enterprise need an Owner or Primary owner to add the connector first. Pro and Max users can add it themselves.
- ChatGPT: Available on Pro, Business, Enterprise, and Education. Write tools are limited to Business, Enterprise, and Education.
- Gemini CLI: Requires Gemini CLI installed and a terminal. This is a developer-tool connection, not a settings screen.
- Gong: Requires a Gong Tech admin.
4. Setup
🔗 The Server URL
https://mcp.spekit.co/mcpThis one URL works across every AI tool that supports Custom connectors and Dynamic registration. You do not need a Client ID or Client secret. You authorize with a standard OAuth sign-in using your Spekit login.
The General Setup Pattern
The steps are similar in every tool:
- Open your AI tool's connector or integration settings. Look for "Connectors," "Custom connectors," "MCP servers," or "Integrations."
- Add a custom connector.
- Paste in the Spekit server URL. If the tool asks for a name, use "Spekit."
- Sign in with your existing Spekit credentials to authorize.
A few things vary by tool. Some need a developer setting turned on first. Some are admin managed. A few use a command line or config file instead of a settings screen. None of this changes the URL, the sign-in, or your Spekit permissions.
Connect to Claude
Who can use this
- Team and Enterprise plans: an Owner or Primary owner adds the connector at the organization level first.
- Pro and Max plans: any user can add it individually.
You need an active Spekit account and a Claude plan that supports connectors (Team, Enterprise, Pro, or Max).
Team and Enterprise plans
Step 1. Owner or Primary owner adds the connector:
- Go to Organization settings, then Connectors.
- Click Add.
- Hover over Custom, then select Web.
- Enter the Spekit server URL.
- Click Add to finish.
Step 2. Members connect their own account:
- Go to Settings, then Customize, then Connectors.
- Find the Spekit connector, labeled "Custom."
- Click Connect, then sign in with your Spekit credentials.
Pro and Max plans
- Go to Customize, then Connectors.
- Click the plus sign, then Add custom connector.
- Enter the Spekit server URL and click Add.
- Select the Spekit connector and click Connect.
- When the "Application Access Request" prompt appears, click Allow Access and sign in with your Spekit credentials.
Connect to ChatGPT
Who can use this Custom MCP connectors are available on ChatGPT Pro, Business, Enterprise, and Education plans. For Spekit, write tools are currently limited by plan:
- Business, Enterprise, and Education can use both read and write tools.
- Pro may be able to use the read tools but not the write tools.
- Plus cannot use custom MCP connectors.
You need an active Spekit account, a plan from the list above, and Developer Mode turned on.
Step 1. Turn on Developer Mode
- Open Settings.
- Go to Connectors, then Advanced settings. Depending on your account, this may appear under Security and login.
- Turn on Developer mode.
Step 2. Add Spekit as a custom connector
- In Settings, then Connectors, click Add custom connector.
- Enter a name, for example "Spekit," and the Spekit server URL, including the
/mcppath. - Create the connection and review the tools it finds.
Step 3. Authenticate. When prompted, sign in with your Spekit credentials.
Step 4. Use it in a conversation. Select the Spekit connector as a source for your conversation.
Connect to Gemini CLI
Who can use this This is a developer-tool connection, not a point-and-click settings page. You need Gemini CLI installed and a terminal.
You need Gemini CLI installed and an active Spekit account. Gemini CLI's OAuth flow signs you in through your existing Spekit login in a browser window.
Step 1. Add the server to your Gemini CLI settings Add an entry to ~/.gemini/settings.json (global) or .gemini/settings.json in your project directory:
{
"mcpServers": {
"spekit": {
"url": "https://mcp.spekit.co/mcp",
"oauth": { "enabled": true }
}
}
}Step 2. Authenticate In Gemini CLI, run:
/mcp auth spekitThis opens a browser window for you to sign in with your Spekit credentials.
Step 3. Confirm it is connected Run /mcp auth with no arguments to list servers and confirm Spekit shows as authenticated.
⚠️ A note on headless environments: The sign-in step opens a real browser window. It will not work over a remote SSH session or in a headless environment without local browser access.
Connect to Gong
Who can use this You need a Gong Tech admin role. This is available on any Gong plan.
This setup runs in the reverse direction from the others. Here Gong itself connects out to Spekit's MCP server as an external data source, so "Ask Gong" can use Spekit content.
📌 Skip the "Client access" fields
Gong's setup screen offers an optional Client ID and Client secret section. Spekit's server does not need it. Leave it collapsed and use Personal access instead (Step 3).
Step 1. Go to MCP connections
- In Gong, go to Admin center.
- Go to Settings, then MCP connections, under Ecosystem.
- Click New connection.
Step 2. Enter connection details
- Connection name: Spekit
- MCP server URL: the Spekit server URL
- Authentication requirement: enabled
Step 3. Choose Personal access, not Shared access Gong offers Shared access (one token for all users) and Personal access (each user authorizes separately). Use Personal access. Spekit's permissions are scoped to each user's role, and Shared access would collapse every Gong user into one Spekit identity.
Step 4. Connect Click Connect and complete Spekit sign-in when prompted. Each user authorizes individually the first time.
Don't See Your Tool?
The connector works with any AI tool that supports custom connectors by URL. Follow the general setup pattern above, using the Spekit server URL. Codex CLI is also supported and connects the same config-based way as Gemini CLI. If you get stuck partway through, reach out to your Spekit contact or email support@spekit.co.