Skip to content
/
Create configuration
Last updated

Create MCP Configuration

🔨 In Development — This section is still being developed and may change.
Create a new MCP (Model Context Protocol) configuration that can be reused across multiple API requests. Configurations store connector settings, credentials, and access permissions.
POSThttps://api.freddy.aitronos.com/v1/mcp/configurations

MCP configurations enable you to define connector settings once and reference them by ID in subsequent requests. Configurations can be private (user-only) or shared with specific users or your entire organization.

Request Body

name string required

Human-readable name for the configuration. Used to identify the configuration in lists and logs. Example: "Production Google Drive", "Sales Team Slack".

connectorId string required

ID of the MCP connector to use. Available connectors: google_drive, github, slack, notion, confluence, sharepoint, gmail, dropbox. See all connectors

configuration object required

Connector-specific configuration settings. Structure varies by connector type. View connector schemas

Show example configurations

Google Drive:

{
  "folderId": "1a2b3c4d5e",
  "includeSubfolders": true,
  "mimeTypes": ["application/pdf", "application/vnd.google-apps.document"]
}

GitHub:

{
  "repository": "acme/backend",
  "branch": "main",
  "paths": ["src/", "docs/"],
  "fileTypes": [".py", ".md"]
}

Slack:

{
  "channels": ["#engineering", "#product"],
  "dateRange": "last_30_days",
  "includeThreads": true
}

description string optional

Optional description explaining the configuration's purpose. Useful for team collaboration. Example: "Access to engineering documentation folder".

shared boolean optional · Defaults to false

Whether the configuration is shared with others. When false, only you can use it. When true, specify sharing permissions via sharedWith.

sharedWith object optional

Defines who can access this configuration. Only applicable when shared is true.

Show properties

users array optional

Array of user IDs to share with. Example: ["user_abc123", "user_xyz789"].

teams array optional

Array of team IDs to share with. Example: ["team_engineering", "team_product"].

organization boolean optional · Defaults to false

Share with entire organization. When true, all organization members can use this configuration.

permissions string optional · Defaults to read

Access level for shared users. Available values: read (view and use), write (modify settings), admin (manage sharing).

metadata object optional

Custom key-value pairs for tagging and filtering configurations. Example: {"environment": "production", "team": "sales"}.

Bash
curl https://api.freddy.aitronos.com/v1/mcp/configurations \
  -H "Authorization: Bearer $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Engineering Docs",
    "connectorId": "google_drive",
    "configuration": {
      "folderId": "1a2b3c4d5e",
      "includeSubfolders": true
    },
    "description": "Access to engineering documentation"
  }'

Response

{
  "id": "mcp_config_abc123",
  "object": "mcp.configuration",
  "name": "Engineering Docs",
  "connectorId": "google_drive",
  "configuration": {
    "folderId": "1a2b3c4d5e",
    "includeSubfolders": true
  },
  "description": "Access to engineering documentation",
  "shared": false,
  "sharedWith": null,
  "metadata": {},
  "createdAt": "2024-10-04T12:00:00Z",
  "updatedAt": "2024-10-04T12:00:00Z",
  "createdBy": "user_xyz789"
}
Previous page
Next page