Skip to content
Last updated

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.aitronos.com/v1/mcp/configurations

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".

connector_id 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 shared_with.

shared_with 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"}.