Documentation Index Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Azure AI Foundry Agent Service provides native MCP support, allowing agents to connect to StackOne’s MCP server for enterprise-grade AI workflows.
Official Docs
Prerequisites
Azure AI Foundry workspace
Azure OpenAI deployment
StackOne API credentials
Quick Start
Connect to StackOne MCP via Azure AI Foundry:
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential
import os
import base64
# Configure StackOne account
STACKONE_ACCOUNT_ID = "<account_id>" # Your StackOne account ID
# Encode StackOne API key
auth_token = base64.b64encode(
f " { os.getenv( 'STACKONE_API_KEY' ) } :" .encode()
).decode()
# Create Azure AI project client
project_client = AIProjectClient.from_connection_string(
credential = DefaultAzureCredential(),
conn_str = "<your-connection-string>"
)
# Register StackOne MCP server
mcp_connection = project_client.connections.create_or_update(
connection_name = "stackone-mcp" ,
properties = {
"connectionType" : "MCP" ,
"serverUrl" : "https://api.stackone.com/mcp" ,
"headers" : {
"Authorization" : f "Basic { auth_token } " ,
"x-account-id" : STACKONE_ACCOUNT_ID ,
"Content-Type" : "application/json" ,
"Accept" : "application/json,text/event-stream" ,
"MCP-Protocol-Version" : "2025-06-18"
}
}
)
# Create agent with StackOne MCP tools
agent = project_client.agents.create_agent(
model = "gpt-5" ,
name = "Platform Data Assistant" ,
instructions = "You help analyze data from connected platforms" ,
tools = [{
"type" : "mcp" ,
"mcp_server" : "stackone-mcp"
}]
)
# Create thread and run
thread = project_client.agents.create_thread()
message = project_client.agents.create_message(
thread_id = thread.id,
role = "user" ,
content = "List Salesforce accounts"
)
run = project_client.agents.create_and_process_run(
thread_id = thread.id,
assistant_id = agent.id
)
print (run.status)
Portal Configuration
You can also configure MCP connections through the Azure AI Foundry portal:
Navigate to your AI Foundry workspace
Go to Connections → Add Connection
Select Model Context Protocol (MCP)
Enter StackOne MCP details:
Server URL : https://api.stackone.com/mcp
Headers : Add authentication headers
Server Label : stackone-mcp
Learn more in Azure docs
Environment Variables
STACKONE_API_KEY =< stackone_api_key >
AZURE_OPENAI_ENDPOINT = your_azure_endpoint
AZURE_OPENAI_KEY = your_azure_key
Resources
Next Steps
OpenAI Agents SDK Use OpenAI Agents SDK with Azure OpenAI
Anthropic SDK Build agents with Anthropic SDK