# Develop with AI

> Give your AI coding agent Temporal expertise and real-time access to Temporal documentation.

Give your AI coding agent Temporal expertise with Skills and real-time documentation access with the Temporal Knowledge Base MCP
Server.

## Skills

Skills give AI agents domain-specific Temporal expertise. They work with Claude Code, Codex, Cursor, and any agent that
supports [Skills](https://agentskills.io).

### Temporal Developer Skill

The [Temporal Developer Skill](https://github.com/temporalio/skill-temporal-developer) gives your AI coding agent
expert-level knowledge of Temporal's programming model — workflow determinism rules, activity patterns, retry policies,
error handling, testing strategies, worker configuration, versioning, and common gotchas.

**Claude Code Plugin**

1. Add the Temporal skills marketplace to Claude Code:

   ```bash
   /plugin marketplace add temporalio/claude-temporal-plugin
   ```

2. Install the Temporal Developer Skill:

   ```bash
   /plugin install temporal@temporal-marketplace
   ```

**Cursor**

Install the Temporal plugin from the [Cursor Marketplace](https://cursor.com/marketplace/temporal), or run the following
command in Cursor's agent chat:

```
/add-plugin temporal
```

**Codex**

Install from the Codex app or CLI:

- **Codex app:** Open the plugins menu, search for **temporal**, then click **+** (or **Add to Codex**).
- **Codex CLI:** Run `/plugin`, search for **temporal**, and mark it for installation.

**npx**

This works with Claude Code, Codex, Cline, and other agents.

Install the skill using the `skills` CLI:

```bash
npx skills add https://github.com/temporalio/skill-temporal-developer
```

**Manual**

Clone the skill repository into your Claude skills directory. Change the target directory if you are using agents other
than Claude:

```bash
git clone https://github.com/temporalio/skill-temporal-developer.git ~/.claude/skills/temporal-developer
```

Restart your coding agent after installing.

### Temporal Cloud Skill

The [Temporal Cloud Skill](https://github.com/temporalio/skill-temporal-cloud) helps your AI coding agent troubleshoot
Temporal Cloud connectivity, authentication, and configuration issues.

**npx**

This works with Claude Code, Codex, Cline, and other agents.

Install the skill using the `skills` CLI:

```bash
npx skills add https://github.com/temporalio/skill-temporal-cloud
```

**Manual**

Clone the skill repository into your Claude skills directory. Change the target directory if you are using agents other
than Claude:

```bash
git clone https://github.com/temporalio/skill-temporal-cloud.git ~/.claude/skills/temporal-cloud
```

Restart your coding agent after installing.

## Temporal Knowledge Base  MCP Server

Connect Temporal expertise directly to your AI assistant for accurate, up-to-date answers about Temporal. The
Temporal knowledge base MCP server gives AI tools real-time access to best practices compiled from our documentation, educational materials, community forum responses, and slack channels, so responses draw from current expertise
rather than training data.

> **ℹ️ Info:**
> Authentication required
>
> The Temporal Knowledge Base MCP Server is publicly available, but requires a one-time login with a Google or GitHub account to enforce rate limits and prevent abuse.
> Only an opaque user ID is used for rate limiting. Your name, email, repositories, and other personal data are not accessed or collected.
>

### Claude Code

Add the Temporal knowledge base MCP server globally so it's available in all your projects:

1. Register the MCP server with Claude Code:

   ```bash
   claude mcp add --scope user --transport http temporal-docs https://temporal.mcp.kapa.ai
   ```

2. Restart Claude Code and run `/mcp` to authenticate with your Google account.

To add the server to a specific project only, omit the `--scope user` flag. This stores the configuration in the
project's `.mcp.json` file:

```bash
claude mcp add --transport http temporal-docs https://temporal.mcp.kapa.ai
```

### Claude Desktop

1. Open Claude Desktop settings
2. Navigate to **Settings > Connectors**
3. Add a new MCP server with the URL: `https://temporal.mcp.kapa.ai`

### Other MCP-compatible tools

The Temporal Knowledge Base MCP Server URL is:

```
https://temporal.mcp.kapa.ai
```

The server requires authentication through MCP OAuth.
Not all MCP clients support this protocol.
If your client supports MCP OAuth, it will open a browser window to verify with Google or GitHub on first connection.
If your client does not support MCP OAuth, you may need to use a stdio proxy that handles the OAuth flow and passes credentials to the remote server.
Check your client's documentation for details on connecting to OAuth-protected MCP servers.