ChatGPT / OpenAI Integration
ChatGPT supports MCP servers natively through the ChatGPT Desktop app. Connect Snipara so ChatGPT can query your documentation directly during conversations.
What You Get
ChatGPT Desktop
Native MCP support in ChatGPT Desktop app. Tools appear automatically in conversations.
OpenAI API
Use Snipara as context provider for any OpenAI API calls (GPT-4o, o1, etc.).
Custom GPTs
Add Snipara as an Action in Custom GPTs to query your docs on behalf of users.
Before You Begin
Make sure you have created a Snipara project and generated an API key.
You'll need your Project Slug (or ID) and API Key from your project's API Keys tab on the Snipara dashboard.
ChatGPT Desktop App (Recommended)
The ChatGPT Desktop app for macOS and Windows supports MCP servers natively. This is the easiest way to connect Snipara to ChatGPT.
Prerequisites
- ChatGPT Desktop app (macOS or Windows)
- A ChatGPT Plus, Team, or Enterprise subscription
- A Snipara project with at least one document indexed
- An API key from your Snipara dashboard
Step 1: Open MCP Settings
In the ChatGPT Desktop app, open Settings (gear icon) and navigate to the MCP Servers section under Beta features.
Step 2: Add Snipara Server
Click Add Server and enter the following configuration:
| Field | Value |
|---|---|
| Name | Snipara |
| Server URL | https://api.snipara.com/mcp/YOUR_PROJECT_SLUG |
| Authentication | API Key — YOUR_API_KEY |
Replace Placeholders
Replace YOUR_PROJECT_SLUG with your project's slug (e.g., my-project) and YOUR_API_KEY with the key from your Snipara dashboard.
Step 3: Enable the Server
After adding the server, toggle it ON. ChatGPT will connect and discover Snipara's tools automatically. You should see a green indicator once connected.
Step 4: Start Querying
Open a new chat and ask questions about your documentation. ChatGPT will automatically use Snipara tools when relevant:
How does authentication work in this project?[Using snipara.rlm_context_query]Based on your documentation, authentication works by...Alternative: stdio Package
If the ChatGPT Desktop app supports stdio-based MCP servers in your version, you can use the snipara-mcp PyPI package:
pip install snipara-mcpor run without installing:uvx snipara-mcpThen configure in the ChatGPT Desktop MCP settings:
{ "mcpServers": { "snipara": { "command": "uvx", "args": ["snipara-mcp"], "env": { "SNIPARA_API_KEY": "YOUR_API_KEY", "SNIPARA_PROJECT_ID": "YOUR_PROJECT_SLUG" } } }}Requires Python
You need Python 3.10+ and uv installed. Install uv with: curl -LsSf https://astral.sh/uv/install.sh | sh
OpenAI API Integration
You can also use Snipara with the OpenAI API directly. Query Snipara's REST API or MCP endpoint, then pass the retrieved context to your OpenAI completions.
import openaiimport requests# 1. Query Snipara for relevant contextresp = requests.post( "https://api.snipara.com/mcp/YOUR_PROJECT_SLUG/tools/invoke", headers={"X-API-Key": "YOUR_API_KEY"}, json={ "name": "rlm_context_query", "arguments": {"query": "How does auth work?", "max_tokens": 4000} })context = resp.json()# 2. Pass context to OpenAIclient = openai.OpenAI()completion = client.chat.completions.create( model="gpt-4o", messages=[ {"role": "system", "content": f"Use this context:\n{context}"}, {"role": "user", "content": "How does auth work?"} ])This approach works with any OpenAI model (GPT-4o, GPT-4o mini, o1, etc.) and gives you full control over how context is injected into your prompts.
Custom GPTs
You can add Snipara as an Action in a Custom GPT so it can query your documentation on behalf of users.
Setup
- Open the GPT Builder and go to the Configure tab
- Scroll down to Actions and click Create new action
- Set the Authentication to API Key with header
X-API-Key - Import the OpenAPI schema from your Snipara project's API settings
- Save and test with a documentation query
OpenAPI Schema
The OpenAPI schema for your project is available at: https://api.snipara.com/mcp/YOUR_PROJECT_SLUG/openapi.json
Available Tools
Once connected, ChatGPT can use all Snipara MCP tools. Here are the most commonly used:
rlm_context_queryFull semantic search with token budgeting
rlm_askQuick query with predictable tokens (~2.5K)
rlm_searchRegex pattern search across docs
rlm_multi_queryBatch multiple queries in one call
rlm_rememberStore facts, decisions, and learnings
rlm_recallSemantically recall stored memories
See the MCP Tools Reference for a full list of all available tools with parameters and examples.
Troubleshooting
- Check that the server URL and API key are correct
- Verify you can reach the endpoint:
curl https://api.snipara.com/mcp/YOUR_PROJECT_SLUG/health - Try removing and re-adding the server in settings
- Restart the ChatGPT Desktop app
- Ensure the server toggle is ON (green indicator)
- Try explicitly asking: "Use Snipara to find..."
- Check that your ChatGPT subscription supports MCP (Plus, Team, or Enterprise)
- Update to the latest ChatGPT Desktop version
- Verify your API key is correct (check for extra spaces)
- Check if the key has expired in your Snipara dashboard
- Regenerate the API key if issues persist
- Ensure the authentication header is set as
X-API-Key
- Check that your documentation has been indexed (use the dashboard)
- Try a simpler query to test connectivity
- Verify the project slug points to the correct project
- Reduce the max_tokens parameter for faster responses