Connecting Your AI Assistant to Sedna with MCP

This guide walks you through connecting AI tools like Claude, Microsoft Copilot, or other compatible assistants to your Sedna workspace. Once connected, your AI assistant can search messages, look up contacts, find job references, and more, directly within your conversations.

What You'll Need

Before you start, you'll need two things from Sedna:

• Your Tenant ID – This identifies your organisation's Sedna workspace
• An API Key – This authenticates your connection

To get these credentials, contact Sedna Support at support@sedna.com and request API access for AI integration. The team will provide your Tenant ID and generate an API key for your organisation.

How It Works

When you connect an AI assistant to Sedna, the assistant gains the ability to:

• Search and retrieve messages
• Look up users and contacts
• Find job references and related communications
• Access category tags and filtered message lists

The AI doesn't store your Sedna data; it simply queries your workspace when you ask it questions, using the same permissions as your API key.

Important Information

API Access Scope: Basic authentication credentials grant access to all API endpoints and team inboxes within your Sedna workspace. However, the MCP server will not return data from solo (personal) inboxes. If there are any teams you DO NOT want the AI system to read from, please communicate the team names to Sedna support before making the integration live.

AI Accuracy Disclaimer: AI assistants can make mistakes. While safeguards have been implemented to improve reliability, it is the customer's responsibility to verify the accuracy of any information returned by the AI. Always review AI-generated responses before taking action, particularly for critical business decisions or communications.

Setting Up the Connection

The exact steps depend on which AI tool you're using, but the core information is the same:

Connection URL: https://sednamcp.com/mcp

Required Settings:

For Claude Desktop or Similar Tools

If your AI tool uses a configuration file, add this entry (replacing the placeholder values with your actual credentials):

{

"mcpServers": {

"sedna-mcp-server": {

"command": "mcp-remote",

"args": [

"https://sednamcp.com/mcp",

"--header", "X-Sedna-Tenant: your-tenant-id",

"--header", "X-Sedna-Api-Key: your-api-key"

]

}

}

}

For Microsoft Copilot Studio

There are two ways to connect Copilot to Sedna: using the built-in MCP connector (recommended) or creating a custom connector via Power Apps.

Option 1: MCP Connector (Recommended)

• Go to the Tools page for your agent
• Select Add a tool
• Select New tool
• Select Model Context Protocol — the MCP onboarding wizard appears

Fill in the required fields:

• Server name: Sedna MCP Server
• Server description: Connects to Sedna to search messages, look up contacts, find job references, and access team inbox data
• Server URL: https://sednamcp.com/mcp

For Authentication, select API key

Configure the API key authentication with your Sedna API Key

Select Create to complete the setup

Option 2: Custom Connector via Power Apps

• Go to the Tools page for your agent
• Select Add a tool
• Select New tool
• Select Custom connector — you'll be taken to Power Apps to create a new custom connector
• Select New custom connector
• Copy the YAML schema below into the connector configuration
• Enter your Tenant ID and API Key when prompted
• Select Continue to complete the setup in Power Apps

YAML Schema for Custom Connector:

yaml

swagger: '2.0'

info:

title: Sedna MCP Server

description: MCP Server for Sedna API integration

version: 1.0.0

host: sednamcp.com

basePath: /

schemes:

- https

consumes:

- application/json

produces:

- application/json

securityDefinitions:

api_key:

type: apiKey

in: header

name: X-Sedna-Api-Key

tenant:

type: apiKey

in: header

name: X-Sedna-Tenant

security:

- api_key: []

tenant: []

paths:

/mcp:

post:

summary: MCP Endpoint

x-ms-agentic-protocol: mcp-streamable-1.0

operationId: InvokeMCP

responses:

'200':

description: Success

For Other Web-Based Tools

Enter the connection URL and add the two header settings (Tenant ID and API Key) in your tool's connection configuration screen.

Once you have confirmed the connection, depending on your platform you will see a list of Sedna MCP “Tools” available for your AI system to collect data through.

Testing Your Connection

Once configured, try asking your AI assistant something simple like:

• "Show me the teams in Sedna"
• "Find users in my Sedna workspace"
• "Look up recent messages"

If the connection is working, the assistant will return results from your Sedna workspace.

Common Issues

"Missing credentials" or "Unauthorised" errors

Double-check that both your Tenant ID and API Key are entered correctly. Both are required.

"Missing tenant" errors

Make sure the X-Sedna-Tenant header is included in your configuration.

Connection timeouts

Check your network connectivity. If the issue persists, try a simpler query first to confirm the connection works.

Security Notes

• Keep your API key confidential; treat it like a password
• Only share credentials with authorised team members/platforms
• If you suspect your API key has been compromised, contact Sedna Support immediately to have it revoked and replaced.