Cursor

Cursor IDE Integration

Cursor is a VS Code fork with AI built in. With IntlPull's MCP server, you can manage translations directly in your editor using Claude.

Quick Start

1. Install the MCP server:

npm install -g @intlpullhq/mcp-server

2. Configure MCP in Cursor Settings (Cmd+,):

Navigate to Features → MCP Servers → Add Server

Or edit ~/.cursor/mcp.json directly:

{
  "mcpServers": {
    "intlpull": {
      "command": "npx",
      "args": ["-y", "@intlpullhq/mcp-server"],
      "env": {
        "INTLPULL_API_KEY": "ip_live_your_api_key"
      }
    }
  }
}

.cursorrules Configuration

Create a .cursorrules file in your project root to teach Cursor your i18n conventions:

# i18n Guidelines

When working with translations in this project:

## Key Conventions
- Always use react-i18next for translations
- Namespace format: feature.section.element (e.g., checkout.form.submitButton)
- Never hardcode user-facing strings
- Use IntlPull MCP to create and manage translation keys

## Translation Workflow
1. Extract hardcoded strings to translation keys
2. Use IntlPull MCP to create keys with English values
3. Add context descriptions for translators
4. Translate to target languages using IntlPull

## Plurals and Formatting
- Use ICU message format for plurals
- Keep key names in English, values localized
- Add max_length constraints for UI elements with limited space

## File Structure
- Translation files: ./messages/{lang}.json
- Use flat keys within namespaces

Using with Claude

Open the Claude panel (Cmd+L) and use natural language to manage translations:

Extract and create keys

"Extract the hardcoded strings from this component and create translation keys in the checkout namespace"

Check translation status

"What translations are missing for Spanish?"

Translate content

"Translate all missing keys to German"

Search existing translations

"Find all keys containing 'button' in the forms namespace"

Verify the Connection

Open Claude (Cmd+L) and ask:

Can you check my IntlPull connection and list my projects?

If you see your projects listed, the connection is working. If not, check that your API key is correct and that the MCP server is properly configured.

Troubleshooting

MCP server not connecting

Make sure you've restarted Cursor after adding the MCP configuration. Check the Cursor output panel for any error messages.

API key not working

Verify there's no trailing space in your API key. You can test it with:curl -H "X-API-Key: ip_live_..." https://api.intlpull.com/v1/projects

Claude not using IntlPull

Be explicit in your prompts: "Use the IntlPull MCP server to..." This ensures Claude knows which tool to use.

Next Steps

MCP Server Reference Full Cursor i18n Workflow Guide Framework Integrations