# AI agents & MCP With Cards you have two options for using AI as agents. Either you create agents that can be used directly in the Cards interface, or you use our MCP connector to connect your own AI software (Mistral, Claude, or other compatible tools) to Cards. In the case of AI agents directly integrated into Cards, OpenAI is used as the engine. Using these agents consumes your AI credits, whereas MCPs do not (since your AI performs the processing). {% hint style="info" %} [Contact us](https://www.cards-microlearning.com/contact) to activate AI Agents and MCP integration. {% endhint %} ### List of AI agents and MCPs

The list of AI agents and 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. In the AI agent list, you will find two sections: one listing your agents (those you created) and the other listing agents created by other members of your team. ### What can an agent do? An AI agent has access to a list of tools, allowing it to interact directly with the content of your Cards space. These tools are the same as those used by MCP connectors. The tools are as follows: * Trainings Tool: allows access to, creation of, and editing of training courses * Chapters Tool: access, creation of, modification, and deletion of chapters * Cards Tool: access, creation, modification, and deletion of content cards * Categories Tool: access, creation, and editing of training categories * Routines Tool: access, creation, and editing of routines (and listing of routine categories) * Steps Tool: access, creation, editing, and deletion of 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. Agents in Cards have access to all of these tools. For MCP connectors, you can generally choose whether or not to enable these tools in your AI software. For more granular permission control, you can create a custom role specific to your AI agent or connector. This permission control applies to Cards, so no connector or agent can override it. For more information, see the "[Custom Roles](https://doc.cards-microlearning.com/english/my-space/custom-roles)" documentation. ### AI Agents #### Create an agent

When you create an AI agent, you give it a first name, a last name, and a role. The content created by this agent will then be easily identifiable in your content listings (the "author" column will display the agent's first and last name). The role you choose must be a custom role. For more information, see the "Custom Roles" documentation. By assigning it a custom role, you can limit its actions on your content (for example, to only allow it to edit its own courses, and not those of other editors). Several configuration settings are available in the right-hand column: * Agent Type: allows you to choose the agent's behavior * Custom Instructions: allows you to "prompt" the agent by giving it instructions that will be applied when you call upon it * Availability: * Private: only you can use the agent * Public: the agent can be used by other editors in your space. #### Use an agent

To use an AI agent, click on the "AI" bubble in the bottom right corner. A panel will open on the side, allowing you to select the agent you want to use. Once you've selected an agent, a chat window will appear, and you can chat directly with the AI agent. In this chat, in the top right corner, you can view your previous conversations and pick up where you left off. The agent knows your first and last name, which allows it to know what content you've created. However, it currently cannot "see" which page you are on: you must therefore specify the name of the training course or its ID if you want the agent to interact with it. ### MCP Connector

To create a connector, you must, as with agents, choose a first name, last name, and role. Once the connector is created, a window will appear with your identification token. This token is only displayed once. Copy it; you will need it in your AI software (Mistral or Claude, for example). On the MCP edit page, you can regenerate a token if needed. The old token will be deleted and can no longer be used. ### Use with Mistral To use MCP Cards in Mistral, go to The Chat ([https://chat.mistral.ai/chat](https://chat.mistral.ai/chathttps://chat.mistral.ai/chat)), then use the "Intelligence" > "Connectors" menu.

On this page, click the "Add a connector" button. A modal window will open allowing you to add a connector. Click the "Custom MCP Connector" tab. You can then enter the MCP information: * Name: Cards * Connector Server:

Mistral will then automatically detect the authentication method: * "API Token Authentication" * Header Name: Authorization * Header Type: Bearer You can now click "Create". Your connector will now appear in your listing. You can click on it to enter your authentication token:

Once the setup is complete, the MCP is ready to be used in The Chat. When you start a new conversation, you have the option to choose Cards as the tool. Click on the "+" in the bottom left corner, and you will be able to select Cards as the connector.

The Chat now has access to your Cards space.