# Update MCP Configuration

div
strong
🔨 In Development
 — This section is still being developed and may change.


Modify an existing MCP configuration's settings, sharing permissions, or metadata.

Update any aspect of an MCP configuration including connector settings, name, description, sharing permissions, and metadata. Only fields provided in the request will be updated; omitted fields remain unchanged.

#### Path Parameters

**`id`** string required

The ID of the MCP configuration to update. Example: `mcp_config_abc123`.

#### Request Body

**`name`** string optional

Updated human-readable name for the configuration.

**`configuration`** object optional

Updated connector-specific configuration settings. Completely replaces the existing configuration object.

**`description`** string optional

Updated description. Pass empty string to clear.

**`shared`** boolean optional

Update sharing status. Setting to `false` removes all sharing permissions.

**`sharedWith`** object optional

Update sharing permissions. Completely replaces existing sharing settings.

details
summary
Show properties
**`users`** array optional

Array of user IDs to share with. Replaces existing user list.

**`teams`** array optional

Array of team IDs to share with. Replaces existing team list.

**`organization`** boolean optional

Share with entire organization. Overrides user and team lists when `true`.

**`permissions`** string optional

Access level for shared users. Values: `read`, `write`, `admin`.

**`metadata`** object optional

Updated metadata. Merges with existing metadata (specify `null` for keys to remove them).

Update Settings

```bash
curl -X PATCH https://api.freddy.aitronos.com/v1/mcp/configurations/mcp_config_abc123 \
  -H "Authorization: Bearer $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Engineering Docs (Updated)",
    "configuration": {
      "folderId": "1a2b3c4d5e",
      "includeSubfolders": true,
      "mimeTypes": ["application/pdf", "text/plain"]
    }
  }'
```


```python
import requests

response = requests.patch(
    "https://api.freddy.aitronos.com/v1/mcp/configurations/mcp_config_abc123",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json={
        "name": "Engineering Docs (Updated)",
        "configuration": {
            "folderId": "1a2b3c4d5e",
            "includeSubfolders": True,
            "mimeTypes": ["application/pdf", "text/plain"]
        }
    }
)

config = response.json()
print(f"Updated: {config['name']}")
```


```javascript
const response = await fetch(
  'https://api.freddy.aitronos.com/v1/mcp/configurations/mcp_config_abc123',
  {
    method: 'PATCH',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: 'Engineering Docs (Updated)',
      configuration: {
        folderId: '1a2b3c4d5e',
        includeSubfolders: true,
        mimeTypes: ['application/pdf', 'text/plain']
      }
    })
  }
);

const config = await response.json();
console.log(`Updated: ${config.name}`);
```

Share with Users

```bash
curl -X PATCH https://api.freddy.aitronos.com/v1/mcp/configurations/mcp_config_abc123 \
  -H "Authorization: Bearer $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "shared": true,
    "sharedWith": {
      "users": ["user_123", "user_456", "user_789"],
      "permissions": "read"
    }
  }'
```


```python
import requests

response = requests.patch(
    "https://api.freddy.aitronos.com/v1/mcp/configurations/mcp_config_abc123",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json={
        "shared": True,
        "sharedWith": {
            "users": ["user_123", "user_456", "user_789"],
            "permissions": "read"
        }
    }
)
```


```javascript
const response = await fetch(
  'https://api.freddy.aitronos.com/v1/mcp/configurations/mcp_config_abc123',
  {
    method: 'PATCH',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      shared: true,
      sharedWith: {
        users: ['user_123', 'user_456', 'user_789'],
        permissions: 'read'
      }
    })
  }
);
```

Share with Organization

```bash
curl -X PATCH https://api.freddy.aitronos.com/v1/mcp/configurations/mcp_config_abc123 \
  -H "Authorization: Bearer $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "shared": true,
    "sharedWith": {
      "organization": true,
      "permissions": "read"
    }
  }'
```


```python
import requests

response = requests.patch(
    "https://api.freddy.aitronos.com/v1/mcp/configurations/mcp_config_abc123",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json={
        "shared": True,
        "sharedWith": {
            "organization": True,
            "permissions": "read"
        }
    }
)

print("Configuration shared with entire organization")
```


```javascript
const response = await fetch(
  'https://api.freddy.aitronos.com/v1/mcp/configurations/mcp_config_abc123',
  {
    method: 'PATCH',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      shared: true,
      sharedWith: {
        organization: true,
        permissions: 'read'
      }
    })
  }
);

console.log('Configuration shared with entire organization');
```

Remove Sharing

```bash
curl -X PATCH https://api.freddy.aitronos.com/v1/mcp/configurations/mcp_config_abc123 \
  -H "Authorization: Bearer $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "shared": false,
    "sharedWith": null
  }'
```


```python
import requests

response = requests.patch(
    "https://api.freddy.aitronos.com/v1/mcp/configurations/mcp_config_abc123",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    },
    json={
        "shared": False,
        "sharedWith": None
    }
)

print("Configuration is now private")
```


```javascript
const response = await fetch(
  'https://api.freddy.aitronos.com/v1/mcp/configurations/mcp_config_abc123',
  {
    method: 'PATCH',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      shared: false,
      sharedWith: null
    })
  }
);

console.log('Configuration is now private');
```

## Response

200 OK

```json
{
  "id": "mcp_config_abc123",
  "object": "mcp.configuration",
  "name": "Engineering Docs (Updated)",
  "connectorId": "google_drive",
  "configuration": {
    "folderId": "1a2b3c4d5e",
    "includeSubfolders": true,
    "mimeTypes": ["application/pdf", "text/plain"]
  },
  "description": "Access to engineering documentation",
  "shared": true,
  "sharedWith": {
    "users": ["user_123", "user_456", "user_789"],
    "permissions": "read"
  },
  "metadata": {
    "environment": "production",
    "team": "engineering"
  },
  "createdAt": "2024-10-04T12:00:00Z",
  "updatedAt": "2024-10-04T15:45:00Z",
  "createdBy": "user_xyz789"
}
```

Errors

```json
{
  "error": {
    "type": "not_found_error",
    "message": "MCP configuration not found",
    "code": "resource_not_found",
    "param": "id"
  }
}
```


```json
{
  "error": {
    "type": "permission_error",
    "message": "You don't have permission to update this configuration",
    "code": "insufficient_permissions"
  }
}
```


```json
{
  "error": {
    "type": "invalid_request_error",
    "message": "Cannot share with users and organization simultaneously",
    "code": "invalid_sharing_config"
  }
}
```