Quick start
-
Add the server to the coding agents that add-mcp finds:
- Sign in from each client.
--global.
add-mcp does not configure Claude, and ignores CLAUDE_CONFIG_DIR. For these, use Setup.
Setup
- Claude Code
- Codex
- Cursor
- VS Code
- Windsurf
- Claude
- Other
Authenticate
Sign in once per client with your TesterArmy account. You do not need an API key.
Your browser opens the TesterArmy sign-in page. Sign in and go back to your client. The client refreshes the token automatically.
To check the connection, ask the agent: “List my TesterArmy projects.”
To change accounts, sign out in your client and sign in again. In Codex, run
codex mcp logout testerarmy.
Teams
One sign-in gives access to all your teams. If you are in more than one team, tell the agent which team to use. The agent can calllist_teams to find it.
What your agent can do
- Create projects, environments, credentials, and project memories.
- Upload mobile app builds.
- Create, edit, and delete tests and groups.
- Run tests and groups. Schedule groups.
- Read transcripts, console logs, and network requests of a run.
- Get a download link for a run video.
get_guide tool.
Example prompts:
Security
- Each tool call checks your current team membership.
- The MCP server does not see your password.
- Tools do not return stored passwords. Transcripts hide steps that use credentials.
- The agent can delete projects, tests, and groups. Connect only clients that you trust.
Troubleshooting
The tool asks which team to use
The tool asks which team to use
You are in more than one team. Tell the agent the team name.
Telemetry is empty
Telemetry is empty
Telemetry is available after the run ends. Mobile runs have app logs only when the run installs
an uploaded app. Safari runs on iOS have no telemetry. Use the transcript instead.