Azure / Azure/api-center

Add more metadata fields when pressing in “Add to VS Code” via the API center portal

Open
#86 1 comment 0 reactions 0 assignees View on GitHub
Feature request Untriaged
Dominant language
PowerShell
Stars
45
Forks
21
Avg merge
21m
Merged PRs (30d)
1

Description

# What are you trying to achieve?

My GitHub Copilot organization uses an API Center MCP Registry with the
[“Registry only” policy](https://docs.github.com/en/copilot/how-tos/administer-copilot/manage-mcp-usage/configure-mcp-server-access). Essentially I would like to use the API center portal's "Install in VS Code" as a recommended way for our developers to install allowed MCP servers with a simple click.

Azure API Center's “Add to VS Code” action for a registered remote MCP server currently only generates:

```json
{
"AKS MCP Server": {
"type": "http",
"url": "https://my-uri/mcp"
},

"Terraform MCP Server": {
"type": "http",
"url": "https://myurl2/mcp"
},
}
```

# Proposed solution

Support setting more fields from metadata . At least gallery and version are required from what I can see. If these fields are not present the installation of the MCP server will be blocked.

Supporting extra fields such as oauth and headers would also be beneficial

```json
"AKS MCP Server": {
"type": "http",
"url": "https://myuri1/mcp",
"oauth": {
"clientId": "my-wellknown-clientid"
},
"gallery": "https://p-ne1apim-apicenter.data.swedencentral.azure-apicenter.ms/workspaces/default",
"version": "v1"
},
"terraform-mcp-server": {
"type": "http",
"url": "https://myuri2/mcp",
"gallery": "https://p-ne1apim-apicenter.data.swedencentral.azure-apicenter.ms/workspaces/default",
"version": "v1",
"headers": {
"Ocp-Apim-Subscription-Key": "placeholder-subkey"
}
},
```

# Alternative solutions

Need to create manual docs or manually crafted VSCode install links. I successfully managed to create a `https://vscode.dev/redirect?url=vscode%...` uri which has every setting I need

# Additional context

https://p-ne1apim-apicenter.portal.swedencentral.azure-apicenter.ms/servers/aks-mcp-server

example MCP server which demonstrates the issue.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.