The Ezekia AI Server allows compatible AI tools to securely connect to your Ezekia account so they can search, retrieve, create and update data using natural language.

Once connected, you can ask an AI assistant to perform actions in Ezekia, build automated workflows, or create custom AI agents that interact directly with your database.

What is Ezekia MCP?

Model Context Protocol (MCP) is an open standard that allows AI tools to securely communicate with external systems.

The Ezekia MCP server allows supported AI tools to:

  • Search people, companies, projects and tasks
  • Create and update records
  • Add notes and tasks
  • Manage candidates and contacts within projects
  • Build automated workflows and AI agents

The AI translates your request into secure actions performed directly in Ezekia.


Two Ways to Connect

There are two different authentication methods depending on the AI platform and use case.

Option 1: OAuth Authentication (Recommended)

This is the preferred option for interactive AI assistants such as ChatGPT and Claude (for use inside of their chat functions).

With OAuth:

  • Users log in with their own Ezekia account
  • No API token is required
  • Permissions come directly from the user's Ezekia account
  • Users only see data they already have permission to access
  • Actions are performed using the authenticated user's permissions

This is the most secure and simplest option for day-to-day AI usage.

Examples of AI tools that support MCP within their chat model: Claude, ChatGPT, Mistral Le Chat, Perplexity (via MCP extensions), Grok (via MCP extensions), and any future AI platforms that support OAuth-based MCP connections.

Option 2: API / Agentic Token Authentication

This option is designed for custom AI applications, automated workflows, and developer tools and IDEs, such as OpenAI Agent Builder, the OpenAI Responses API / Agents SDK, Microsoft Copilot Studio and Google Gemini.

With token authentication:

  • An API token is created inside Ezekia
  • Permissions are determined by the selected permission group
  • The connection is shared wherever that token is configured
  • Anyone with access to the configured AI agent or application may be able to use the connection

This approach is best suited to centralised AI agents, service accounts and automation.


Security & Permissions

OAuth Connections

When using OAuth:

  • Each user authenticates individually
  • Permissions come from the user's Ezekia account
  • Users cannot access another user's Ezekia data simply because they share a ChatGPT or Claude workspace
  • Actions are logged and performed using that user's permissions

This is the recommended authentication method wherever supported.

Token-Based Connections

When using an API or Agentic Token:

  • Permissions are controlled by the token's permission group
  • Anyone with access to the configured AI agent may be able to use the connection associated with that token
  • We recommend granting the minimum permissions required
  • Dedicated service accounts should be used where appropriate

This model is best suited to automation, shared AI agents and system integrations.


Supported AI Platforms

The following platforms currently support MCP directly or through custom integrations.

OAuth-Based Platforms

  • ChatGPT
  • Claude
  • Mistral Le Chat

Agentic, Developer & Coding Tools - Token-Based Platforms

  • OpenAI Agent Builder
  • OpenAI Responses API / Agents SDK
  • Google Gemini (availability varies by plan and region)
  • Microsoft Copilot Studio
  • Cursor
  • Windsurf
  • Cline
  • Continue.dev
  • Roo Code
  • VS Code MCP-compatible extensions
  • Other MCP-compatible IDEs and developer tools

Custom Integrations

Any MCP-compatible application can connect to the Ezekia MCP endpoint:

https://mcp.ezekia.com


Platform Setup Guides

Choose the guide that matches your platform:

ChatGPT (OAuth)
How to Connect ChatGPT to the Ezekia AI Server (MCP) (enabling the connector/app in chat)

Claude (OAuth)
How to Connect Claude AI Chat to the Ezekia AI Server (Anthropic MCP) (enabling the connector in a chat)

OpenAI Agent Builder (Token)

How to Connect OpenAI Agents to the Ezekia AI Server (MCP) to enable Workflows

Claude Code Agent Builder (Token)

How to Connect Claude Code to the Ezekia AI Server (for Agents using API Token)

Google Gemini
 https://support.google.com/gemini/answer/13695044 (Note: This links to Google's own MCP documentation)

Microsoft Copilot Studio

The Ezekia MCP app is available directly from the Microsoft Copilot Studio marketplace. https://learn.microsoft.com/en-us/microsoft-copilot-studio/advanced-connectors

API / Agentic Token Setup

Generate an API Token for the Ezekia AI Connector (MCP)


Using Ezekia with Natural Language

Once connected, you can ask your AI assistant questions such as:

  • "Find senior product managers in Berlin."
  • "Show me all assignments created this month."
  • "Create a follow-up task for next week."
  • "Add a note to this company."
  • "Update the project status to completed."
  • "Find candidates with board-level healthcare experience."
  • "Show me all open opportunities owned by Sarah."

The AI will automatically use your Ezekia permissions and available actions.

Common Use Cases

  • Candidate sourcing and research
  • Company and client searches
  • Workflow automation
  • Task and note creation
  • AI-assisted reporting
  • Internal AI assistants
  • Executive search research workflows
  • Automated business development processes
  • Talent mapping and market intelligence
  • Administrative automation


Frequently Asked Questions

If multiple people share a ChatGPT or Claude workspace, can they access my Ezekia data?

Not when using OAuth authentication. Each user must authenticate using their own Ezekia account and will only have access to data permitted by their individual permissions.

Simply sharing a ChatGPT Team/Business/Enterprise or Claude Business workspace does not grant access to another user's Ezekia data.

What happens if I use an API or Agentic Token instead?

Anyone with access to the configured AI agent or application may be able to use the connection associated with that token. For this reason, token-based authentication is recommended for service accounts, shared automation and centralised AI agents, while OAuth is recommended for individual users.

Which authentication method should I choose?

Use OAuth if:

  • Individual users are interacting with ChatGPT, Claude or Mistral Le Chat
  • You want permissions tied to individual users
  • You want the simplest and most secure setup

Use API/Agentic Tokens if:

  • You are building automated workflows
  • You are creating shared AI agents
  • You are connecting developer tools or custom applications
  • You require a service-account style implementation


Privacy, Security & Compliance Considerations

Ezekia's AI integrations operate within the same security and permissions framework as the core platform.

Data Access & Permissions

When using MCP, AI assistants can only access data that the authenticated user or API token is authorised to access.

For OAuth-based connections:

  • Access is tied to the authenticated Ezekia user
  • The AI can only access records and functionality available to that user
  • Actions are performed using that user's permissions

For API or Agentic Token-based connections:

  • Access is controlled by the permission group assigned to the token
  • Anyone with access to the configured AI agent or application may be able to use the connection associated with that token
  • We recommend granting the minimum permissions required and using dedicated service accounts where appropriate

AI Processing

Some AI-enabled functionality within Ezekia and connected AI platforms may process requests through third-party AI providers such as OpenAI, Anthropic, Google, Microsoft or other model providers selected by the client. Data transmitted between systems is encrypted in transit using industry-standard security protocols.

Where OpenAI APIs are used, OpenAI states that data submitted through its API services is not used to train its models.

External AI Platforms

When using MCP with external AI platforms such as ChatGPT, Claude, Gemini, Copilot Studio, Cursor, Windsurf, Cline or other MCP-compatible tools:

  • Data access remains governed by Ezekia permissions and authentication controls
  • Any use of external AI services is also subject to the privacy policies, data processing terms and security controls of the relevant provider
  • Clients retain full control over which AI services are connected and how data is shared

GDPR & Transparency

As with any AI-enabled workflow, organisations should assess their own:

  • GDPR obligations
  • Privacy notice requirements
  • Transparency obligations
  • Internal AI governance policies

based on how AI tools are deployed, the categories of personal data being processed, and the jurisdictions in which they operate.


Additional Resources

Ezekia Privacy Policy
https://www.ezekia.io/privacy-policy

Ezekia GDPR Guidance
Data Retention in Ezekia: Roles, Responsibilities, and GDPR Compliance

Other AI Privacy Information
https://openai.com/policies/privacy-policy

https://openai.com/enterprise-privacy/

https://www.anthropic.com/legal/privacy

https://support.google.com/gemini/answer/13594961

https://www.microsoft.com/en-us/microsoft-copilot/for-individuals/privacy

https://legal.mistral.ai/terms/privacy-policy

Please refer to each provider's website for the most up-to-date privacy information.


Information Security Standards

Ezekia maintains ISO 27001 certification and can provide supporting documentation upon request.


Complete List of Supported Actions

The available actions supported by the Ezekia AI Connector are continuously updated as new capabilities are released. For the most up-to-date list of supported actions, visit:

Settings → Integrations → Ezekia AI Connector

or directly: https://ezekia.com/#/settings/integrations → Ezekia AI Connector


Getting Help

If you need assistance configuring the Ezekia AI Connector, authentication methods, or connecting supported AI platforms, please contact: support@ezekia.com