Overview
The Clarier MCP connector is a secure bridge between Claude and your organization’s Clarier workspace. It lets Claude use Clarier’s governed records as the source of truth for AI tools, vendors, requests, approvals, usage, and compliance.
The connector is hosted and maintained by Clarier. It uses the Model Context Protocol’s Streamable HTTP transport and OAuth 2.1 authentication, so users sign in with their existing Clarier account instead of copying API keys into Claude.
Tool availability is dynamic. A company administrator may enable or disable the connector, write actions, AI usage, identity, vendor timeline, or other features. Administrators also see capabilities that standard users do not.
At a glance
| Authentication | OAuth 2.1 with user consent |
|---|---|
| Transport | Streamable HTTP |
| Access model | Existing Clarier company, role, SSO, and feature permissions |
| Actions | Read tools plus confirmation-based writes when enabled |
| Tenant model | One selected Clarier company per connection |
| API key required | No |
Before you connect
- An active Clarier account and membership in the company you want to connect.
- Access to Claude and permission to install or connect directory connectors in your Claude organization.
- The Clarier connector must be enabled for your company by a Clarier administrator.
- If your company requires Microsoft SSO, sign in to Clarier with Microsoft before connecting.
- Write actions appear only when your company enables them and you grant write access during connection.
Connect in Claude
- In Claude, open Settings → Connectors or browse the Claude Connectors Directory.
- Find Clarier and select Add or Connect.
- A Clarier authorization page opens. Sign in with your existing Clarier account.
- Choose the Clarier company you want this connection to use.
- Review the requested access. Enable write access only if you want Claude to prepare and submit supported changes.
- Approve the connection and return to Claude.
- In a conversation, open Search and tools and make sure the Clarier tools you want to use are enabled.
Check that it works
Using Clarier, tell me which company I am connected to and summarize our AI tool estate.
If Clarier is not visible in your organization’s directory yet, contact your Clarier administrator or dev@clarier.ai. Pilot organizations may receive separate connection instructions from Clarier.
What you can do
Find the right AI tool
Search your company's AI inventory, see which tools are active, in review, decommissioned, or discovered as shadow AI, and filter them by status, category, department, or risk.
Review vendor risk
Retrieve Clarier's latest vendor report for a tool, including available risk scores, strengths, risks, and recommended actions.
Track requests and approvals
Check the workflow and approval progress for a requested tool, view recent requests, and see approval items currently waiting for your own review.
Understand adoption and shadow AI
When enabled for administrators, summarize synced AI usage by application, department, or user and review promoted shadow-AI detections.
Review governance posture
Summarize departments, identity counts, vendor changes, and the latest available compliance assessment snapshots.
Submit governed changes
When write access is enabled, prepare and submit a new AI tool request. Administrators can also prepare metadata updates for existing tools. Claude must show the proposed fields before the final write.
Permissions and tool availability
Clarier does not expose the same tool list to everyone. Claude receives a tool catalog for the connected user’s current role and the company’s enabled features. The complete administrative read/write connection currently exposes up to 25 tools.
| Capability | Standard user | Company administrator |
|---|---|---|
| Company and AI-estate summary | Yes | Yes |
| Search/list tools and view tool details | Yes | Yes |
| Read existing vendor reports | Yes | Yes |
| View request status and recent requests | Yes | Yes |
| View own pending approvals | Yes | Yes |
| View departments and enabled vendor timeline | Yes | Yes |
| Prepare a new AI tool request | When write access is enabled | When write access is enabled |
| Identity and AI-usage summaries | No | When the corresponding feature is enabled |
| Shadow-AI and compliance summaries | No | When the corresponding feature is enabled |
| Prepare tool metadata updates | No | When write access is enabled |
- A missing capability usually means it is not enabled for your company, role, or connection; it is not necessarily an error.
- The company selected during authorization is fixed to that connection. A prompt cannot switch the connector into another company.
- Clarier rechecks membership, role, SSO policy, feature availability, and connection status on every request.
Safe write actions
Supported writes use a prepare → review → commit flow.
- Claude reads your company’s current request-form configuration and available choices.
- Claude prepares the action without changing the Clarier record.
- Claude shows every field that will be submitted, including defaults and optional fields that were left blank.
- You can ask Claude to change any value and prepare it again.
- Only after you explicitly approve the final field set does Claude commit the action.
Supported writes
- Create a new AI tool request — available to standard users and administrators when write access is enabled.
- Update an existing tool’s owner, category, or notes — administrators only, when write access is enabled.
Not supported through the connector
- Changing approval status.
- Approving or rejecting an approval request.
- Generating a new vendor report.
- Sending a request into an approval workflow.
- Uploading arbitrary files or Claude Skill packages.
Example prompts
Inventory and approvals
Which AI tools are currently approved for my company? Group them by department.
Is ChatGPT already approved for our company? If it is, show me its approved use cases and data classifications.
What AI tool requests were submitted most recently, and what stage is each one in?
What is the current request and approval status for Fireflies.ai?
Do I have any Clarier approvals waiting for me?
Risk and compliance
Show me Clarier's latest vendor risk report for Microsoft Copilot and summarize the most important risks and actions.
Which high-risk AI tools are active or currently under review?
Summarize our latest available compliance posture and identify the weakest evidence coverage.
Usage and shadow AI — administrator examples
Summarize AI usage from the last 30 days by application, then highlight the top three departments.
What shadow AI has Clarier detected, and which applications or users account for the most activity?
Submit a request
Help me request Fireflies.ai for our Operations team. First show me the request fields and available options, ask for anything important that is missing, and show me the complete request before submitting it.
For any write, explicitly ask Claude to show the complete proposed field set before it commits the action.
Tool reference
Technical tool names are shown for administrators and reviewers. Most users can simply describe the outcome they want in natural language.
Read tools available to eligible users
| Tool | What it does |
|---|---|
get_company_info | Returns basic information about the connected Clarier company. |
get_estate_summary | Summarizes the company's AI tool estate. |
search_tools | Searches for an AI tool or vendor by name or domain. |
list_tools | Lists AI tools with optional status, risk, category, or discovery filters. |
get_tool_details | Returns the stored metadata for a named AI tool. |
get_tool_report | Returns the latest existing Clarier vendor risk report for a named tool. |
get_tools_by_status | Lists tools in a specific Clarier status. |
get_recent_requests | Lists recently requested AI tools. |
get_tools_by_risk | Lists tools by risk level. |
get_tools_by_category | Lists tools by category. |
get_discovered_tools | Lists promoted discovered or shadow-AI tools. |
get_departments_summary | Summarizes configured departments and their AI tools. |
get_department_tools | Lists AI tools associated with a department. |
get_vendor_timeline | Returns enabled vendor-change timeline events for a named tool. |
get_request_status | Returns workflow steps, approval progress, and current status for a request. |
list_my_pending_approvals | Lists approval items waiting for the connected user without exposing approval links or tokens. |
get_request_form_options | Returns the company's live request fields, labels, required fields, hints, choices, and departments. |
Administrator read tools
| Tool | What it does |
|---|---|
get_identity_count | Returns synced identity totals when the identity feature is enabled. |
get_ai_usage_summary | Summarizes synced AI usage over a selected time window. |
get_ai_usage_breakdown | Breaks down synced AI usage by application, department, or user. |
get_shadow_ai_summary | Summarizes promoted shadow-AI detections. |
get_compliance_overview | Returns the latest available compliance assessment snapshot per supported framework. |
Write tools
| Tool | Who can use it | What it does |
|---|---|---|
prepare_create_tool_request | Eligible users with write access | Prepares—but does not submit—a new AI tool request using the company's configured form. |
prepare_update_tool | Administrators with write access | Prepares—but does not apply—an owner, category, or notes update for an existing tool. |
commit_action | Eligible users with a prepared action | Applies the previously reviewed action after explicit approval. |
Tools may be hidden when the connected role, company configuration, feature flags, or read/write consent do not permit them.
Security and data handling
Authentication and authorization
- Users authenticate through OAuth 2.1 with their existing Clarier account; no Clarier API key is entered into Claude.
- Each connection is bound to the specific Clarier company selected during authorization.
- Every request rechecks the connection, company membership, current role, SSO policy, and company feature settings.
- Companies can enable the connector as read-only or allow supported writes.
- Users can revoke their own connection from Clarier, and access stops immediately on subsequent connector requests.
Tenant and role isolation
- Claude cannot select a company by placing a company identifier in a prompt or tool argument.
- Record lookups are scoped to the connected company.
- Administrator-only information and actions are not exposed to standard users.
- If a user’s membership or role is removed, existing connector access is denied.
Data sent to Claude
When you ask Claude to use Clarier, the requested Clarier tool result is returned to Claude and becomes part of that conversation’s context. Anthropic’s handling of that content is governed by your Claude plan, organization settings, and agreement with Anthropic.
The Clarier connector does not read your unrelated Claude conversations, Claude memory, or conversation history. It does not use your customer data to train models.
Clarier does not persist raw read-tool prompts or results for the connector. Connection records, rate-limit metadata, security/audit events, and the allowlisted fields of a prepared write are retained as needed to operate and audit the service.
Manage or revoke a connection
Disconnect in Claude
Open Claude Settings → Connectors, select Clarier, and choose Disconnect. This removes Claude’s active connection.
Revoke in Clarier
In Clarier, open your user menu and select Connected AI clients. Revoke the Claude connection you no longer want to authorize.
Switch companies
Each active Claude connection is bound to one Clarier company. To use a different company, revoke or disconnect the existing connection and connect again, choosing the other company during authorization.
Troubleshooting
- Clarier does not appear in Claude
- Your Claude organization may not have installed or allowed the connector yet. Ask your Claude organization administrator to add Clarier, or contact dev@clarier.ai.
- Authorization fails or the sign-in window does not open
- Disconnect the Clarier connector in Claude, sign in to Clarier in a normal browser tab, and try Connect again. Confirm that pop-ups are allowed and that you are using the Clarier account invited to the intended company.
- Microsoft SSO is required
- Sign out of Clarier, sign back in using Microsoft, then reconnect the connector. Companies that enforce Microsoft SSO cannot authorize the connector from a non-SSO session.
- The connector shows no tools
- The connection may be disconnected or revoked, or the Clarier connector may be disabled for your company. Reconnect once. If tools are still missing, ask your Clarier administrator or contact dev@clarier.ai.
- A tool or report is missing
- Capabilities vary by role and company features. A vendor report must already exist in Clarier before the connector can read it. Generate or manage missing reports in the Clarier application.
- Write tools are missing
- Your connection may be read-only, your company may have disabled connector writes, or the action may require a company-administrator role. Reconnect and grant write access only if your administrator allows it.
- A request is missing required information
- Ask Claude to read the Clarier request-form options first. Your company controls which fields are enabled, required, and limited to specific choices.
- The connector became unauthorized after working previously
- The connection may have been revoked, your company membership or role may have changed, or the connector may have been disabled. Disconnect and reconnect only if you still have valid Clarier access.
- The daily request limit was reached
- Clarier applies a company-configurable daily connector limit. Try again after the next UTC day or contact your Clarier administrator.
- I still need help
- Email dev@clarier.ai with your company name, the approximate time of the problem, the Claude product you were using, and the visible error message. Never email access tokens, OAuth secrets, passwords, or confidential prompt content.
FAQ
- What is MCP?
- The Model Context Protocol is an open standard that lets AI clients discover and call tools provided by external services. Clarier uses MCP to make its governed AI records and supported actions available to Claude.
- Does Claude receive everything in our Clarier workspace?
- No. The connector returns only the information requested through an available tool, within the connected user's company and permissions. Tool outputs may still contain sensitive company information, so use them only in Claude environments approved by your organization.
- Does the connector use a Clarier API key?
- No. Users authenticate with OAuth 2.1 and their existing Clarier account.
- Can a prompt switch the connector to another company?
- No. The selected company is fixed to the authorized connection. Switching companies requires reconnecting and choosing the other company.
- Can Claude approve or reject requests for me?
- Not in the current connector. Claude can show approval items waiting for you and explain request progress, but approval decisions are completed in Clarier.
- Can Claude submit a new AI tool request?
- Yes, when your company and connection allow writes. Claude first prepares the full request for your review and submits it only after your explicit approval.
- Why do different users see different tools?
- The available tool list reflects the connected user's Clarier role, the company's enabled features, and whether the connection has write access.
- Does Clarier MCP expose MCP resources?
- No. The current connector exposes MCP tools rather than browsable MCP resources. Seeing zero resources in an MCP client is expected.
- Can I use the endpoint with another MCP client?
- Clarier uses the standard remote MCP Streamable HTTP transport, but an external client must also be supported by Clarier's OAuth configuration. Contact dev@clarier.ai before configuring a client that is not available through an approved directory listing.
Technical details
| Server type | Remote MCP server |
|---|---|
| Production endpoint | https://platform.clarier.ai/api/mcp |
| Transport | Streamable HTTP |
| Authentication | OAuth 2.1 |
| Tools | Up to 25, dynamically filtered by role and features |
| MCP resources | None in the current version |
| Support | dev@clarier.ai |
| Status | https://status.clarier.ai |
The endpoint alone is not sufficient for every third-party client. Clarier uses pre-registered OAuth client configuration for supported clients rather than public dynamic client registration. Contact Clarier before attempting a manual integration.
Support
Need help with the Clarier connector?
Contact the Clarier team for connection support, company enablement, or security-review questions.