> For the complete documentation index, see [llms.txt](https://doc.cards-microlearning.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.cards-microlearning.com/english/ai-agents-and-mcp/mcp-connectors.md).

# MCP connectors

### MCP Connectors list

<figure><img src="/files/9G6d4rrMSke60STfJ4b8" alt=""><figcaption><p>MCP Connectors list</p></figcaption></figure>

The list of MCP connectors is available on the "Apps & Integrations" page, then under "AI Agents & MCP Connectors." The tabs allow you to view the list of AI Agents or MCP connectors.

The MCP tab allows you to view and edit the different connectors that have been added to your Cards account.

### What can an AI do with an MCP connector?

An AI has access, via an MCP connector, to a list of tools that allow it to interact directly with the content of your Cards space.

The tools are as follows:

* Trainings Tool: allows it to access, create, and edit training courses
* Chapters Tool: access, create, edit, and delete chapters
* Cards Tool: access, create, edit, and delete content cards
* Categories Tool: access, create, and edit training categories
* Routines Tool: access, create, and edit routines (and list routine categories)
* Steps Tool: access, create, edit, and delete routine steps
* Giphy Search Tool: search for GIFs on Giphy
* Unsplash Search Tool: search for images on Unsplash
* YouTube Search Tool: search for videos on YouTube
* Image Upload Tool: upload an image to your media library from a URL.

You can generally choose whether or not to enable these tools in your AI software via an approval system.

For more granular permission control, you can create a custom role specific to your AI agent or connector. Since this permission control applies to the Cards side, no connector or agent can override it.

For more information, see the "[Custom Roles](/english/my-space/custom-roles.md)" documentation.

### MCP connection options

You have two options for connecting Cards to your AI software via an MCP.

The first is to go directly into your software (Claude, Mistral, ChatGPT) and add a custom connector by entering the MCP URL: `https://api.cards-microlearning.com/mcp/cards`

Your software will then prompt you to connect with Cards. The connector will be created automatically upon login.

The second option (the "advanced" option) is to manually create a connector in Cards, which will provide you with your OAuth login credentials. You can then configure these credentials in your AI tool when adding the Cards connector.

{% hint style="info" %}
Note: If you use social login (Google, Microsoft, Apple) or SSO to log in to Cards, you will need to use the 2nd option, as only email/password login is available through your AI software.
{% endhint %}

### Edit a connector

Once your AI software is connected, you can find the connector in your list on the "Apps & Integrations" > "AI Agents & MCP Connectors" > "MCP Connectors" tab.

Upon connection, the connector is automatically configured with a first name (yours) and a last name (the name of the software you are using, if provided by the tool). Its role is also automatically assigned based on yours. You are free to modify these three pieces of information; they do not affect the connection itself between your AI tool and Cards.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.cards-microlearning.com/english/ai-agents-and-mcp/mcp-connectors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.