Connect InterviewFlowAI to Claude or Codex through the Model Context Protocol.
Connect InterviewFlowAI to an AI assistant through the Model Context Protocol (MCP). You can list AI Interviewers, review Candidate details, summarize interviews, update Candidate notes, and change supported Interviewer settings without switching applications.
Sign in to MCP with the same email address you use for your InterviewFlowAI account. This connects the authenticated MCP session to the correct Company. If you use email and password, sign up for Auth0 first and verify your email address. Check your spam or junk folder for the verification email.
claude mcp add-json interviewflowai '{"type":"http","url":"https://api.interviewflowai.com/mcp","oauth":{"clientId":"ACYUUGM2Ia9tbufCbwQSELKlyTvlgxem","callbackPort":8765,"scopes":"mcp:read mcp:write"}}'
2
Authenticate
Start Claude Code, run /mcp, select interviewflowai, and choose Authenticate.
3
Confirm the connection
Run /mcp again and confirm that the server is connected.
1
Add a custom connector
Open Customize → Connectors, click +, and select Add custom connector. Enter InterviewFlowAI as the name and https://api.interviewflowai.com/mcp as the server URL.
2
Configure authentication
Select Always required under Authentication. Select Use your own OAuth client under OAuth client.
3
Enter the OAuth client ID
Enter ACYUUGM2Ia9tbufCbwQSELKlyTvlgxem as the Client ID. Leave OAuth Client Secret blank, then click Add.
4
Authenticate
Select Connect or Authenticate for InterviewFlowAI and complete the Auth0 login. Enable InterviewFlowAI from the Connectors menu in your conversation.
1
Configure the MCP server
Open the Codex configuration file for your operating system:
macOS and Linux:~/.codex/config.toml
Windows PowerShell:$HOME\.codex\config.toml
Windows Command Prompt:%USERPROFILE%\.codex\config.toml
The mcp:read scope lets your assistant list and inspect AI Interviewers and Candidates. The mcp:write scope lets an Owner update Candidate notes, custom fields, visibility, and archived status. InterviewFlowAI does not expose write tools to Viewers.Confirm every write action before you allow your assistant to make a change.
