> For the complete documentation index, see [llms.txt](https://docs.currents.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.currents.dev/ai/connect/chatgpt.md). # ChatGPT Install the Currents plugin from the ChatGPT plugin directory and sign in, or add Currents as a developer-mode app when the directory is not available to you Currents is listed in the ChatGPT plugin directory as [Currents](https://chatgpt.com/plugins/plugin_asdk_app_6abc73667f608191b7511e1375170326). Install it once and sign in to Currents, and ChatGPT can read your runs, test results, failure evidence and analytics in any new chat. There is no server URL to enter and no app to create. The plugin brings the [Currents MCP server skills](/ai/agent-skills/agent-skill-currents-mcp.md) with it: `fix-failing-tests`, `collect-evidence` and `browser-evidence`. ChatGPT knows those workflows without being told. ChatGPT and [Codex](/ai/connect/codex.md) share one plugin directory, so the same Currents plugin is the one to install in both. ## Install the Currents plugin 1. Open [the Currents plugin](https://chatgpt.com/plugins/plugin_asdk_app_6abc73667f608191b7511e1375170326). Or, in ChatGPT, open **Plugins** and search for **Currents**. 2. Install the plugin. 3. When ChatGPT asks you to connect, [sign in](#sign-in). On a Business, Enterprise or Education workspace, an admin decides who can use plugins. If Currents shows **Disabled by admin**, ask your workspace admin to allow it, or [add Currents as a developer-mode app](#add-currents-as-a-developer-mode-app). ## Sign in When ChatGPT first connects, a Currents sign-in page opens. Sign in, choose the organization ChatGPT will work in, and approve the permissions it asks for. See [Sign in once](/ai/connect.md#sign-in-once) for what each screen shows. ChatGPT renews the connection on its own after that. ## Use it in a chat Start a new chat after you install the plugin. Describe the task and ChatGPT picks the Currents tools, or type `@` and choose **Currents** or one of its skills. Then ask about your projects: > What broke in the last failed run of `` on main? Open a Jira issue for it. ChatGPT asks you to confirm tool calls that change data. Check the input before you confirm a write, especially `currents-delete-run`, which permanently deletes a run. Currents does not ask for confirmation. To revoke ChatGPT's access from the Currents side, see [Revoke a connection](/ai/connect.md#revoke-a-connection). ## Other ways to connect ### Add Currents as a developer-mode app Use a developer-mode app only when your workspace does not allow the Currents plugin. Developer mode is available on the web for Plus, Pro, Business, Enterprise and Education accounts. On a Business, Enterprise or Education workspace, an admin may need to allow it first. 1. In [ChatGPT](https://chatgpt.com), open **Settings → Security and login** and turn on **Developer mode**. 2. Go to [ChatGPT Plugins](https://chatgpt.com/plugins) and select the plus button. 3. Fill in the app details: * **Name**: `Currents` * **Description**: `Test results, flaky tests and CI failures from Currents` * **MCP server URL**: `https://mcp.currents.dev/mcp` * **Authentication**: OAuth 4. Leave the client ID and secret empty. ChatGPT identifies itself to Currents on its own. If ChatGPT asks how to register, choose the Client ID Metadata Document option. 5. Create the app, then [sign in](#sign-in). The app is listed under **Drafts** in your app settings. To use the app, open the **+** menu in the composer, choose **Developer mode**, and select **Currents**. The app's details page in your app settings turns individual Currents tools on or off, and refreshes the app to pick up tools Currents has added since you created it. ### If you created a developer-mode app before A developer-mode app you created earlier keeps working. Installing the plugin as well gives you two Currents connections. To move to the plugin, delete the app from your app settings, then [install the Currents plugin](#install-the-currents-plugin) and sign in again. ## Troubleshooting | What you see | What to do | | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | | Currents shows **Disabled by admin** | Ask your workspace admin to allow the Currents plugin. | | ChatGPT does not use Currents | Start a new chat, then type `@` and choose **Currents**. | | Two Currents entries | One is a developer-mode app. See [If you created a developer-mode app before](#if-you-created-a-developer-mode-app-before). | For other errors, see [Troubleshooting](/ai/connect.md#troubleshooting). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.currents.dev/ai/connect/chatgpt.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.