1# Foundry Project Connections
2 
3Connections authenticate and link external resources to a Foundry project. Many agent tools (Azure AI Search, Bing Grounding, MCP) require a project connection before use.
4 
5## Managing Connections via MCP
6 
7Use the Foundry MCP server for all connection operations. The MCP tools handle authentication, validation, and project scoping automatically.
8 
9| Operation | MCP Tool | Description |
10|-----------|----------|-------------|
11| List all connections | `project_connection_list` | Lists project connections and can filter by category or target |
12| Get connection details | `project_connection_get` | Retrieves a specific connection by `connectionName` |
13| Create a connection | `project_connection_create` | Creates or replaces a project connection to an external resource |
14| Update a connection | `project_connection_update` | Updates auth, category, target, or expiry on an existing connection |
15| Delete a connection | `project_connection_delete` | Removes a connection from the project by name |
16| List supported categories/auth types | `project_connection_list_metadata` | Lists valid connection categories and auth types before create/update |
17 
18> 💡 **Tip:** Use `project_connection_get` or `project_connection_list` to resolve the connection name and full connection resource ID before configuring agent tools that require `project_connection_id`.
19 
20## Create Connection via Portal
21 
221. Open [Microsoft Foundry portal](https://ai.azure.com)
232. Navigate to **Operate** → **Admin** → select your project
243. Select **Add connection** → choose service type
254. Browse for resource, select auth method, click **Add connection**
26 
27## Connection ID Format
28 
29For REST and TypeScript samples, the full connection ID format is:
30 
31```
32/subscriptions/{subId}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}/projects/{project}/connections/{connectionName}
33```
34 
35Python and C# SDKs resolve this automatically from the connection name.
36 
37## Common Connection Types
38 
39| Type | Resource | Used By |
40|------|----------|---------|
41| `azure_ai_search` | Azure AI Search | AI Search tool |
42| `bing` | Grounding with Bing Search | Bing grounding tool |
43| `bing_custom_search` | Grounding with Bing Custom Search | Bing Custom Search tool |
44| `api_key` | Any API-key resource | MCP servers, custom tools |
45| `azure_openai` | Azure OpenAI | Model access |
46| `AzureStorageAccount` | Azure Blob Storage | Dataset upload via `evaluation_dataset_create` |
47 
48## RBAC for Connection Management
49 
50| Role | Scope | Permission |
51|------|-------|------------|
52| **Azure AI Project Manager** | Project | Create/manage project connections |
53| **Contributor** or **Owner** | Subscription/RG | Create Bing/Search resources, get keys |
54 
55## Troubleshooting
56 
57| Error | Cause | Fix |
58|-------|-------|-----|
59| `Connection not found` | Name mismatch or wrong project | Use `project_connection_list` to find the correct `connectionName` |
60| `Unauthorized` creating connection | Missing Azure AI Project Manager role | Assign role on the Foundry project |
61| `Invalid connection ID format` | Using name instead of full resource ID | Use `project_connection_get` to resolve the full ID |
62