root.agentConnectors.toolSource object

{
  "plugin": {
    "id": "{string}",
    "file": "{string}"
  },
  "remoteMcpServer": {
    "mcpServerUrl": "{string}",
    "mcpToolDescription": {
      mcpToolDescription object
    },
    "authorization": {
      authorization object
    }
  },
  "localMcpServer": {
    "mcpServerIdentifier": "{string}",
    "mcpToolDescription": {
      mcpToolDescription object
    },
    "authorization": {
      authorization object
    }
  }
}

{
  "type": "object",
  "description": "Configuration details for connectors that provide tools for agents, either via a plugin, a remote MCP server or a local MCP server. One and only one of the above properties MUST be defined within a tool source object.",
  "properties": {
    "plugin": {
      "type": "object",
      "description": "Configuration details for connectors that leverage a Plugin Manifest. Both the id and file properties must be provided.",
      "properties": {
        "id": {
          "type": "string",
          "description": "The unique identifier of the plugin that provides the tools.",
          "maxLength": 64
        },
        "file": {
          "$ref": "#/definitions/relativePath",
          "description": "The relative path to the plugin manifest file within the app package."
        }
      },
      "required": [
        "id",
        "file"
      ],
      "additionalProperties": false
    },
    "remoteMcpServer": {
      "type": "object",
      "description": "Adds support for connectors that leverage a Remote MCP Server as the source of data.",
      "additionalProperties": false,
      "properties": {
        "mcpServerUrl": {
          "$ref": "#/definitions/secureHttpUrl",
          "description": "The URL of the remote MCP Server."
        },
        "mcpToolDescription": {
          "type": "object",
          "description": "Configuration for MCP tool descriptions by file reference. When this property is present it indicates that dynamic discovery will not be used.",
          "properties": {
            "file": {
              "$ref": "#/definitions/relativePath",
              "description": "The relative path to the MCP tool description file within the app package."
            }
          },
          "additionalProperties": false
        },
        "authorization": {
          "type": "object",
          "description": "Authorization configuration for connecting to the remote MCP server. The design mirrors that of Plugin Manifests https://learn.microsoft.com/microsoft-365-copilot/extensibility/api-plugin-manifest-2.3",
          "additionalProperties": false,
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "None",
                "OAuthPluginVault",
                "ApiKeyPluginVault",
                "DynamicClientRegistration",
                "AzureKeyVault",
                "ConnectionVault"
              ],
              "description": "The type of authorization required to invoke the MCP server. Supported values are: \u0027None\u0027 (anonymous access), \u0027OAuthPluginVault\u0027 (OAuth flow with referenceId), \u0027ApiKeyPluginVault\u0027 (API Key with referenceId), \u0027DynamicClientRegistration\u0027 (dynamic client registration with referenceId), \u0027AzureKeyVault\u0027 (Azure Key Vault integration), \u0027ConnectionVault\u0027 (Power Platform connector-managed connection referenced by referenceId)."
            },
            "referenceId": {
              "type": "string",
              "maxLength": 128,
              "description": "A reference identifier used when type is OAuthPluginVault, ApiKeyPluginVault, DynamicClientRegistration, AzureKeyVault, or ConnectionVault. The referenceId value is acquired independently when providing the necessary authorization configuration values. This mechanism exists to prevent the need for storing secret values in the plugin manifest."
            }
          },
          "required": [
            "type"
          ],
          "if": {
            "properties": {
              "type": {
                "enum": [
                  "OAuthPluginVault",
                  "ApiKeyPluginVault",
                  "DynamicClientRegistration",
                  "AzureKeyVault",
                  "ConnectionVault"
                ]
              }
            }
          },
          "then": {
            "required": [
              "referenceId"
            ]
          }
        }
      },
      "required": [
        "mcpServerUrl"
      ]
    },
    "localMcpServer": {
      "type": "object",
      "description": "Adds support for connectors that leverage a local MCP Server as the source of data.",
      "additionalProperties": false,
      "properties": {
        "mcpServerIdentifier": {
          "type": "string",
          "maxLength": 128,
          "description": "The unique identifier of the local MCP Server deployed via some secure mechanism to the user\u0027s desktop."
        },
        "mcpToolDescription": {
          "type": "object",
          "additionalProperties": false,
          "description": "Configuration for MCP tool descriptions by file reference. When this property is present it indicates that dynamic discovery will not be used.",
          "properties": {
            "file": {
              "$ref": "#/definitions/relativePath",
              "description": "The relative path to the MCP tool description file within the app package."
            }
          }
        },
        "authorization": {
          "type": "object",
          "description": "Authorization configuration for connecting to the local MCP server. The design mirrors that of Plugin Manifests https://learn.microsoft.com/microsoft-365-copilot/extensibility/api-plugin-manifest-2.3",
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "None",
                "OAuthPluginVault",
                "ApiKeyPluginVault",
                "DynamicClientRegistration",
                "AzureKeyVault",
                "ConnectionVault"
              ],
              "description": "The type of authorization required to invoke the MCP server. Supported values are: \u0027None\u0027 (anonymous access), \u0027OAuthPluginVault\u0027 (OAuth flow with referenceId), \u0027ApiKeyPluginVault\u0027 (API Key with referenceId), \u0027DynamicClientRegistration\u0027 (dynamic client registration with referenceId), \u0027AzureKeyVault\u0027 (Azure Key Vault integration), \u0027ConnectionVault\u0027 (Power Platform connector-managed connection referenced by referenceId)."
            },
            "referenceId": {
              "type": "string",
              "maxLength": 128,
              "description": " (maxLength: 128)\tA reference identifier used when type is OAuthPluginVault, ApiKeyPluginVault, DynamicClientRegistration, AzureKeyVault, or ConnectionVault. The referenceId value is acquired independently when providing the necessary authorization configuration values. This mechanism exists to prevent the need for storing secret values in the plugin manifest."
            }
          },
          "additionalProperties": false,
          "required": [
            "type"
          ],
          "if": {
            "properties": {
              "type": {
                "enum": [
                  "OAuthPluginVault",
                  "ApiKeyPluginVault",
                  "DynamicClientRegistration",
                  "AzureKeyVault",
                  "ConnectionVault"
                ]
              }
            }
          },
          "then": {
            "required": [
              "referenceId"
            ]
          }
        }
      },
      "required": [
        "mcpServerIdentifier"
      ]
    }
  },
  "additionalProperties": false
}

{
  "remoteMcpServer": {
    "mcpServerUrl": "{string}",
    "mcpToolDescription": {
      mcpToolDescription object
    },
    "authorization": {
      authorization object
    }
  }
}

{
  "type": "object",
  "description": "Configuration details for connectors that provide tools for agents via a remote MCP server.",
  "properties": {
    "remoteMcpServer": {
      "type": "object",
      "description": "Configuration details for a connector that provides tools via a remote MCP server.",
      "additionalProperties": false,
      "properties": {
        "mcpServerUrl": {
          "$ref": "#/definitions/secureHttpUrl",
          "description": "The URL of the remote MCP Server."
        },
        "mcpToolDescription": {
          "type": "object",
          "description": "Configuration for MCP tool descriptions by file reference.",
          "properties": {
            "file": {
              "$ref": "#/definitions/relativePath",
              "description": "The relative path to the MCP tool description file within the app package."
            }
          },
          "required": [
            "file"
          ],
          "additionalProperties": false
        },
        "authorization": {
          "type": "object",
          "description": "Authorization configuration for connecting to the local MCP server. The design mirrors that of Plugin Manifests https://spec-hub.azurewebsites.net/specifications/PluginManifest-2.3.html",
          "additionalProperties": false,
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "None",
                "OAuthPluginVault",
                "ApiKeyPluginVault",
                "DynamicClientRegistration",
                "AzureKeyVault"
              ],
              "description": "The type of authorization required to invoke the MCP server. Supported values are: \u0027None\u0027 (anonymous access), \u0027OAuthPluginVault\u0027 (OAuth flow with referenceId), \u0027ApiKeyPluginVault\u0027 (API Key with referenceId), \u0027DynamicClientRegistration\u0027 (dynamic client registration with referenceId)."
            },
            "referenceId": {
              "type": "string",
              "maxLength": 128,
              "description": "A reference identifier used when type is OAuthPluginVault, ApiKeyPluginVault, or DynamicClientRegistration. The referenceId value is acquired independently when providing the necessary authorization configuration values. This mechanism exists to prevent the need for storing secret values in the plugin manifest."
            }
          },
          "required": [
            "type"
          ],
          "if": {
            "properties": {
              "type": {
                "enum": [
                  "OAuthPluginVault",
                  "ApiKeyPluginVault",
                  "DynamicClientRegistration",
                  "AzureKeyVault"
                ]
              }
            }
          },
          "then": {
            "required": [
              "referenceId"
            ]
          }
        }
      },
      "required": [
        "mcpServerUrl"
      ]
    }
  },
  "additionalProperties": false
}

{
  "remoteMcpServer": {
    "mcpServerUrl": "{string}",
    "mcpToolDescription": {
      mcpToolDescription object
    },
    "authorization": {
      authorization object
    }
  }
}

{
  "type": "object",
  "description": "Configuration details for connectors that provide tools for agents via a remote MCP server.",
  "properties": {
    "remoteMcpServer": {
      "type": "object",
      "description": "Configuration details for a connector that provides tools via a remote MCP server.",
      "additionalProperties": false,
      "properties": {
        "mcpServerUrl": {
          "$ref": "#/definitions/secureHttpUrl",
          "description": "The URL of the remote MCP Server."
        },
        "mcpToolDescription": {
          "type": "object",
          "description": "Configuration for MCP tool descriptions by file reference.",
          "properties": {
            "file": {
              "$ref": "#/definitions/relativePath",
              "description": "The relative path to the MCP tool description file within the app package."
            }
          },
          "required": [
            "file"
          ],
          "additionalProperties": false
        },
        "authorization": {
          "type": "object",
          "description": "Authorization configuration for connecting to the local MCP server. The design mirrors that of Plugin Manifests https://spec-hub.azurewebsites.net/specifications/PluginManifest-2.3.html",
          "additionalProperties": false,
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "None",
                "OAuthPluginVault",
                "ApiKeyPluginVault",
                "DynamicClientRegistration"
              ],
              "description": "The type of authorization required to invoke the MCP server. Supported values are: \u0027None\u0027 (anonymous access), \u0027OAuthPluginVault\u0027 (OAuth flow with referenceId), \u0027ApiKeyPluginVault\u0027 (API Key with referenceId), \u0027DynamicClientRegistration\u0027 (dynamic client registration with referenceId)."
            },
            "referenceId": {
              "type": "string",
              "maxLength": 128,
              "description": "A reference identifier used when type is OAuthPluginVault, ApiKeyPluginVault, or DynamicClientRegistration. The referenceId value is acquired independently when providing the necessary authorization configuration values. This mechanism exists to prevent the need for storing secret values in the plugin manifest."
            }
          },
          "required": [
            "type"
          ],
          "if": {
            "properties": {
              "type": {
                "enum": [
                  "OAuthPluginVault",
                  "ApiKeyPluginVault",
                  "DynamicClientRegistration"
                ]
              }
            }
          },
          "then": {
            "required": [
              "referenceId"
            ]
          }
        }
      },
      "required": [
        "mcpServerUrl",
        "mcpToolDescription"
      ]
    }
  },
  "additionalProperties": false
}

{
  "remoteMcpServer": {
    "mcpServerUrl": "{string}",
    "mcpToolDescription": {
      mcpToolDescription object
    },
    "authorization": {
      authorization object
    }
  }
}

{
  "type": "object",
  "description": "Configuration details for connectors that provide tools for agents via a remote MCP server.",
  "properties": {
    "remoteMcpServer": {
      "type": "object",
      "description": "Configuration details for a connector that provides tools via a remote MCP server.",
      "additionalProperties": false,
      "properties": {
        "mcpServerUrl": {
          "$ref": "#/definitions/secureHttpUrl",
          "description": "The URL of the remote MCP Server."
        },
        "mcpToolDescription": {
          "type": "object",
          "description": "Configuration for MCP tool descriptions, either by file reference or inline content (but not both). When this property is present it indicates that dynamic discovery will not be used.",
          "properties": {
            "file": {
              "$ref": "#/definitions/relativePath",
              "description": "The relative path to the MCP tool description file within the app package."
            }
          },
          "required": [
            "file"
          ],
          "additionalProperties": false
        },
        "authorization": {
          "type": "object",
          "description": "Authorization configuration for connecting to the local MCP server. The design mirrors that of Plugin Manifests https://spec-hub.azurewebsites.net/specifications/PluginManifest-2.3.html",
          "additionalProperties": false,
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "None",
                "OAuthPluginVault",
                "ApiKeyPluginVault",
                "DynamicClientRegistration"
              ],
              "description": "The type of authorization required to invoke the MCP server. Supported values are: \u0027None\u0027 (anonymous access), \u0027OAuthPluginVault\u0027 (OAuth flow with referenceId), \u0027ApiKeyPluginVault\u0027 (API Key with referenceId), \u0027DynamicClientRegistration\u0027 (dynamic client registration with referenceId)."
            },
            "referenceId": {
              "type": "string",
              "maxLength": 128,
              "description": "A reference identifier used when type is OAuthPluginVault, ApiKeyPluginVault, or DynamicClientRegistration. The referenceId value is acquired independently when providing the necessary authorization configuration values. This mechanism exists to prevent the need for storing secret values in the plugin manifest."
            }
          },
          "required": [
            "type"
          ],
          "if": {
            "properties": {
              "type": {
                "enum": [
                  "OAuthPluginVault",
                  "ApiKeyPluginVault",
                  "DynamicClientRegistration"
                ]
              }
            }
          },
          "then": {
            "required": [
              "referenceId"
            ]
          }
        }
      },
      "required": [
        "mcpServerUrl",
        "mcpToolDescription"
      ]
    }
  },
  "additionalProperties": false
}