Connectors

Bring your tools into the conversation

Content work rarely stays in one place. Connectors let Aiko reach into your team's external tools on your behalf, so you can act on tasks, docs, and data without leaving the chat. With connectors, you can, for example:

• Ask Aiko to create or update tasks and projects in Asana.
• Work with Jira issues and Confluence pages from the Aiko chat.
• Read and write Notion pages and databases through conversation.
• Track your brand's visibility across AI search platforms using Peec AI.
• Get up-to-date information from the web as part of any chat response.

Beyond these, connect Aiko to any other tool your team relies on by adding it as a custom connector.

Set up connectors

How you set up a connector depends on its type:

• A predefined connector provided by Kontent.ai needs to be enabled for your environment.
• A custom connector for your own tools needs to be added and configured.

Enable a connector

Each connector must be enabled for your environment before your team can use it. To enable connectors for your environment:

1. In Kontent.ai, go to Environment settings > Connectors.
2. Toggle the connectors you want to enable for the environment.
   • Web search is enabled by default.

Each team member then connects their own account.

Add a custom connector

Add a custom connector to bring a tool that exposes a remote MCP server into Aiko's chat. To add a custom connector:

1. In Environment settings, select Connectors.
2. Click Add connector.
3. Enter a Name and Description for the connector.
4. Enter the Remote MCP server URL. Use an absolute HTTP or HTTPS URL without query parameters.
5. (Optional) Enter a Client ID and Client secret, if the MCP server requires a pre-registered OAuth client.
   • Leave both fields empty if the server supports dynamic client registration.
6. Click Add connector.

The connector appears in the list with a Custom label and is enabled for the environment right away. Each team member then connects their own account the same way as with predefined connectors.

Edit a custom connector

1. In Environment settings > Connectors, click the custom connector you want to edit.
2. Update the details as needed.
3. Click Save to confirm the changes.

What your MCP server needs to support

A custom connector's MCP server needs to:

• Be reachable over HTTPS, using Streamable HTTP transport.
• Support OAuth 2.0/2.1 authorization with standard metadata discovery. Kontent.ai finds the OAuth endpoints automatically, so there's no field to enter them manually. Servers without authentication, or protected only by static API keys, don't work as custom connectors.
• Support dynamic client registration, or provide a pre-registered OAuth client whose Client ID and Client secret you enter in the dialog when adding the connector.

If the OAuth server restricts redirect URIs, allowlist the Kontent.ai callback: https://app.kontent.ai/connectors/callback

Connect your account

Each team member connects their own external account via OAuth. Aiko then acts under that person's identity, not a shared account.

1. Go to Aiko Agent to open a new chat.
2. Click Connectors below the chat input.
3. Toggle the connector you want to use.
4. In the new tab that opens, review the requested permissions and grant access.

Your connector is ready to use. Repeat the steps for each connector you want to connect.

Use connectors in the chat

Once connected, you can ask Aiko to do something involving a connected tool. For example:

• "Create an Asana task in the Marketing project called 'Review June blog post' and assign it to me."
• "Find the brand guidelines page in Notion and suggest edits to align the 'April campaign' item with the tone of voice guidelines."

For best results, follow the prompting best practices for Aiko.

Disable a connector

To fully revoke access, also remove the connection in the external service's own settings.

For your account

To disable a connector for your own account only:

1. Go to Aiko Agent to open a new chat.
2. Click Connectors below the chat input.
3. Toggle the connector you want to disable.

For your environment

To disable a connector for the entire environment:

1. In Kontent.ai, go to Environment settings > Connectors.
2. Toggle the connectors you want to disable for the environment.

Disabling a custom connector keeps its configuration.

Delete a custom connector

To delete a custom connector for the entire environment:

1. Click a custom connector in the list to open it for editing.
2. Click Delete and then click Delete again to confirm the deletion.

This action cannot be undone.

Considerations

• Only project managers can enable or disable connectors for an environment, and add, edit, or delete custom connectors. Once enabled, all team members in that environment can connect their own accounts.
• Once you connect your account, the connector is available across all your chats.
• Connectors are available in the Aiko chat and in Aiko's bulk operations. Bulk operations use the connected accounts of the user who started the run.
• Using connectors counts toward your AI credits.
• Stored tokens are encrypted and scoped per environment.
• Custom connectors must support OAuth 2.x authorization. Servers without authentication, or protected only by static API keys, aren't supported.
• You can add up to 20 custom connectors per environment. Predefined connectors don't count toward this limit.
• Expert agents don't have access to connectors.
• Connectors can't be configured through the Management API or any SDK. All configuration is done in the Kontent.ai UI.

Help shape what comes next

Your input helps us improve this feature. If you have any suggestions, questions, or feedback, we’d love to hear from you. Share your experience using the button in Kontent.ai or in the Learn portal.