Connecting to Claravine via the Model Context Protocol (MCP)
Connect an AI assistant such as Claude, ChatGPT, or Goose to Claravine. Once connected, you can find templates, validate data, and create submissions by asking in plain language.
In this article
- About the Claravine MCP connector
- Before you start
- Connect your AI assistant
- Authentication details
- What your AI assistant can do
- Limits
- Troubleshooting
About the Claravine MCP connector
The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to outside platforms. Claravine's MCP connector gives your AI assistant direct access to your templates, Lists, and submissions, with your governance rules applied to everything it submits.
Why use it
- Work faster. Submit and validate data in a conversation instead of filling out forms.
- Catch errors early. Your assistant validates rows against the template's rules before anything is submitted.
- Lower the learning curve. New users can ask what a template needs instead of searching for documentation.
Try prompts like these
- "Find my Social Media Campaign template and show me the fields I need to fill out."
- "What values are allowed in the Region field of our Campaign template?"
- "Validate this file against my Ads template, then submit it if there are no errors."
Before you start
Pick an AI assistant
The connector works with any MCP-compatible client. These are the ones we recommend:
| Client | Sign-in method | Notes |
|---|---|---|
| Claude | OAuth | Team and Enterprise plans may need an org Owner to add the connector first. |
| ChatGPT | OAuth | Requires Developer mode. |
| Goose | OAuth or API key | Supports both methods. |
Claravine is a custom connector, so it won't appear in the Claude or ChatGPT connector directories. You add it with the server URL below.
Check your account setup
- OAuth sign-in requires an Auth0 Tenant Organization ID on your Claravine account. An admin can confirm this under Account > Details. If it's missing, click Configure account on new Auth0 Tenant.
- Each environment needs its own connection. To work in a QA or sandbox account, add a separate connection for it.
Connect your AI assistant
Use this server URL for Claude and ChatGPT:
https://mcp.claravine.com/oauth/mcp
Open the steps for your assistant.
Claude
- Go to Settings > Connectors and click Add custom connector.
- Name it Claravine and paste the server URL.
- Click Connect. Sign in with your Claravine credentials when the browser window opens.
Note: On Claude Team or Enterprise, an org Owner may need to add the connector first under Organization settings > Connectors.
ChatGPT
- Turn on Developer mode in Settings > Apps & Connectors > Advanced.
- Create a new connector, paste the server URL, and choose OAuth.
- Sign in with your Claravine credentials when prompted.
Goose or another MCP client
- Add a new custom extension or connector in your client.
- Set the transport type to Streamable HTTP.
- Enter the URL for your sign-in method:
- OAuth:
https://mcp.claravine.com/oauth/mcp - API key:
https://mcp.claravine.com/mcp(see API key setup for the required headers)
- OAuth:
- Save and connect.
You only sign in once per device.
Tip: Most clients let you require approval before a tool runs. Turn this on for actions like creating a submission so nothing is submitted by accident.
Authentication details
Each sign-in method uses its own URL. Your client won't connect if the URL and method don't match.
OAuth (recommended)
Sign in with your existing Claravine credentials. No API key needed.
| Transport type | Streamable HTTP |
| URL | https://mcp.claravine.com/oauth/mcp |
Single sign-on (SSO)
SSO works through OAuth. If your company signs in to Claravine with SSO, the MCP sign-in follows the same flow. Not sure if your account uses SSO? Ask your Claravine admin or contact Claravine Support.
API key (Goose and other advanced clients)
Use a generated key and secret instead of signing in. Your account must have public API keys enabled. If you don't see API Keys in Account Settings, contact your Claravine admin or Claravine Support.
- In Claravine, go to Account Settings > API Keys and click Create API Key.
- Copy the key and secret and store them somewhere secure.
- In your MCP client, set the transport type and URL below.
- Add both headers, replacing the placeholders with your key and secret.
| Transport type | Streamable HTTP |
| URL | https://mcp.claravine.com/mcp |
Header: x-claravine-key
|
your-key |
Header: x-claravine-secret
|
your-secret |
What your AI assistant can do
Templates
| Action | What it does |
|---|---|
| List templates | Returns every template available to your account. |
| Search templates | Finds templates by full or partial name. |
| Get template details | Shows each field's type, required status, form visibility, order, and source List. |
Lists
| Action | What it does |
|---|---|
| Get List details | Returns the List's name, type (drop-down, drill-down, or dependent), row count, and column order. |
| Get List values | Returns values. Filter by parent value, search for a word, or limit the rows returned. |
| Find List values | Matches your values to the exact List spelling ("europe" becomes "Europe"). Checks up to 25 values at a time. |
Submissions and data
| Action | What it does |
|---|---|
| Validate rows | Checks rows against the template's rules without saving anything. |
| Create a submission | Submits up to 1,000 new rows. |
| Update existing rows | Updates rows by Claravine ID and confirms with you before overwriting. |
| Check submission status | Returns the processing status of a submission. |
| List submissions | Shows a template's submissions, with optional date filters. |
| Get submission data | Retrieves the rows from one completed submission. |
| Get dataset | Returns a template's full current dataset across all submissions. |
Tip: Always validate before submitting. If any row fails during a real submission, the whole submission moves to a pending state and no integrations run until it's fixed.
Your assistant can also use this data to export CSV or Excel files (if your client supports files), spot mismatched or hidden-character values, and compare templates or submissions.
Not available through the connector
Make these changes in the Claravine app:
- Create, edit, or delete Lists and List values
- Create or edit templates, fields, field sets, or patterns
- Change users, permissions, or account settings
- Approve, reject, or delete submissions
Limits
- Up to 1,000 rows per submission or validation request.
- After a submission, the server checks status for up to 30 seconds. If it's still pending, ask your assistant to check the submission status.
- Submission data is only available after processing is Complete.
- Field names must match the template exactly.
Troubleshooting
| Problem | Check |
|---|---|
| Client won't connect | Confirm the transport type is Streamable HTTP and the URL matches your sign-in method. |
| OAuth sign-in fails | Confirm your account has an Auth0 Tenant Organization ID under Account > Details. |
| API key rejected | Re-copy the key and secret with no extra spaces, and confirm both headers are set. |
| Can't find a template or submission | Confirm you're connected to the right environment and the UUID is correct. |
Still stuck? Contact Claravine Support.
Watch a video: How Claravine Connects to Your AI Workflow with MCP
Updated
Comments
0 comments
Please sign in to leave a comment.