Conecte Claude, Claude Code, ChatGPT, Cursor, VS Code ou Codex ao seu workspace do AmICited por MCP. Uma URL, login por OAuth e uma chave de API como alternativa.
O AmICited mantém um servidor MCP (Model Context Protocol) sempre ativo. Depois que seu cliente de IA está conectado, ele pode ler seus dados de visibilidade, executar relatórios e, com acesso de escrita, adicionar prompts, gerar artigos ou registrar anotações, tudo em uma conversa normal. Cada recurso do dashboard também é distribuído como ferramenta MCP, então não há nada que você faça no app que um agente não possa fazer.
Um plano que inclua o MCP. O MCP está disponível no teste de 7 dias e nos planos Pro, Premium e Enterprise. Os workspaces Starter podem ver a URL do servidor, mas as conexões são recusadas até o plano ser atualizado. Veja planos e limites.
Permissões de editor ou superiores no workspace. A página MCP orienta os membros sem elas a pedir a um proprietário ou administrador do workspace.
Um saldo de créditos positivo. As leituras por MCP são gratuitas, mas o endpoint verifica se o workspace tem créditos antes de responder. Veja créditos.
O workspace não está na URL. Ele vem da sua credencial: com OAuth, você escolhe o workspace na tela de consentimento, e uma chave de API já pertence a um workspace. Você também pode copiar a URL da página MCP no app, que a mostra com um botão Copy URL e as mesmas instruções por cliente abaixo. O transporte é HTTP streamable.
Cole https://api.flowhunt.io/mcp/amicited e clique em Add.
Clique em Connect no novo conector e aprove o acesso na janela do navegador que abrir. Escolha seu workspace na tela de consentimento.
Em um chat, abra o menu de ferramentas e confirme que o conector do AmICited está ativado.
Alternativa com chave de API (arquivo de configuração do Claude Desktop). Adicione isto em mcpServers em ~/Library/Application Support/Claude/claude_desktop_config.json no macOS e reinicie o Claude Desktop:
Os conectores MCP personalizados exigem o Developer mode, disponível nos planos pagos do ChatGPT (Plus, Pro, Team, Enterprise). Em workspaces Business, Enterprise e Edu, um administrador pode precisar ativá-lo para você.
No ChatGPT, abra Settings e depois Apps & Connectors.
Adicione um conector personalizado e cole https://api.flowhunt.io/mcp/amicited.
Aprove o acesso na janela do navegador que abrir.
Alternativa com chave de API. Na etapa 4, escolha a autenticação por chave de API e cole a chave de API do seu workspace. Salve o conector e depois ative-o em um novo chat.
Cursor
Na página MCP do app, selecione Cursor e clique em Add to Cursor. O Cursor instala o servidor e faz o login para você.
Se o botão não abrir o Cursor, adicione o servidor manualmente nas configurações do Cursor, em MCP, ou edite ~/.cursor/mcp.json (ou um .cursor/mcp.json por projeto):
Alternativa com chave de API. Adicione "headers": { "Authorization": "Bearer <your-workspace-api-key>" } à entrada. Você também pode executar MCP: Add Server…, escolher HTTP (HTTP or Server-Sent Events), colar a URL e adicionar o cabeçalho Authorization quando solicitado.
Codex
O Codex se conecta como um cliente MCP remoto padrão. Adicione o servidor e depois faça o login:
Um Codex executado com configurações de aprovação rígidas ainda alcança todas as ferramentas somente leitura por read_tool. Veja toolsets e ferramentas.
Cole a URL mais um cabeçalho Authorization: Bearer
Workspace
Escolhido na tela de consentimento
Fixado pela chave
Permissões
amicited:read para conectar e ler; amicited:write também é necessário para escrita
Acesso total ao workspace
Revogação
Connected clients → Revoke na página MCP
Exclua ou faça a chave expirar
O OAuth é o melhor padrão: não há segredo para colar em um arquivo de configuração, cada cliente aparece pelo nome na página MCP, em Connected clients, e você pode revogar um sem tocar nos outros. Um token OAuth somente leitura pode listar e ler tudo, mas qualquer ferramenta que cria, edita ou exclui recusará com uma mensagem que cita o escopo amicited:write. Tentar de novo não ajuda; reconecte com acesso de escrita.
Trate uma chave de API como uma senha
Qualquer pessoa com uma chave de API do workspace pode executar todas as ferramentas do servidor sobre os dados do seu workspace, inclusive escrita. Prefira o OAuth, mantenha as chaves fora de repositórios compartilhados e use uma variável de ambiente quando seu cliente permitir.
Peça algo pequeno ao seu agente: “List my AmICited domains.” Ele deve chamar list_domains e devolver seus domínios pelo nome. Depois tente “Show my AI visibility for the last 30 days”, que usa prompt_analytics.
Se a conexão for recusada, a mensagem geralmente diz o motivo:
Plano. “requires a Pro plan or above”: o plano do proprietário do workspace não inclui o MCP.
Créditos. O saldo do workspace é zero ou negativo. Recarregue e tente de novo.
Limite de taxa. As chamadas de ferramentas têm um limite por workspace por hora: 120 no teste, 600 no Pro, 2.000 no Premium, ilimitado no Enterprise. A mensagem diz quando a janela é reiniciada. Listar ferramentas e ler skills não contam.
# Conectar o servidor MCP
Conecte Claude, Claude Code, ChatGPT, Cursor, VS Code ou Codex ao seu workspace do AmICited por MCP. Uma URL, login por OAuth e uma chave de API como alternativa.
O AmICited mantém um servidor MCP (Model Context Protocol) sempre ativo. Depois que seu cliente de IA está conectado, ele pode ler seus dados de visibilidade, executar relatórios e, com acesso de escrita, adicionar prompts, gerar artigos ou registrar anotações, tudo em uma conversa normal. Cada recurso do dashboard também é distribuído como ferramenta MCP, então não há nada que você faça no app que um agente não possa fazer.
## Antes de começar
- **Um plano que inclua o MCP.** O MCP está disponível no teste de 7 dias e nos planos Pro, Premium e Enterprise. Os workspaces Starter podem ver a URL do servidor, mas as conexões são recusadas até o plano ser atualizado. Veja [planos e limites](/docs/account/plans-and-limits/).
- **Permissões de editor ou superiores** no workspace. A página **MCP** orienta os membros sem elas a pedir a um proprietário ou administrador do workspace.
- **Um saldo de créditos positivo.** As leituras por MCP são gratuitas, mas o endpoint verifica se o workspace tem créditos antes de responder. Veja [créditos](/docs/account/credits/).
## A URL do servidor
Há uma única URL para todos:
```text
https://api.flowhunt.io/mcp/amicited
```
O workspace não está na URL. Ele vem da sua credencial: com OAuth, você escolhe o workspace na tela de consentimento, e uma chave de API já pertence a um workspace. Você também pode copiar a URL da página **MCP** no app, que a mostra com um botão **Copy URL** e as mesmas instruções por cliente abaixo. O transporte é HTTP streamable.
## Conecte seu cliente
Escolha seu cliente. Cada aba começa com o login por OAuth recomendado e termina com a alternativa da chave de API.
Os conectores que você adiciona no claude.ai também ficam disponíveis no app Claude Desktop.
1. Abra as [configurações de conectores do Claude](https://claude.ai/customize/connectors).
2. Clique em **+** e depois em **Add custom connector**.
3. Cole `https://api.flowhunt.io/mcp/amicited` e clique em **Add**.
4. Clique em **Connect** no novo conector e aprove o acesso na janela do navegador que abrir. Escolha seu workspace na tela de consentimento.
Em um chat, abra o menu de ferramentas e confirme que o conector do AmICited está ativado.
**Alternativa com chave de API (arquivo de configuração do Claude Desktop).** Adicione isto em `mcpServers` em `~/Library/Application Support/Claude/claude_desktop_config.json` no macOS e reinicie o Claude Desktop:
```json {title="claude_desktop_config.json"}
{
"mcpServers": {
"amicited": {
"type": "http",
"url": "https://api.flowhunt.io/mcp/amicited",
"headers": {
"Authorization": "Bearer <your-workspace-api-key>"
}
}
}
}
```
Registre o servidor uma vez pelo terminal:
```bash
claude mcp add --transport http amicited https://api.flowhunt.io/mcp/amicited
```
Depois execute `/mcp` dentro do Claude Code, escolha **Authenticate** e aprove o acesso na janela do navegador que abrir.
**Alternativa com chave de API.** Adicione o servidor sob a chave `mcpServers` de nível superior em `~/.claude.json` e reinicie o Claude Code:
```json {title="~/.claude.json"}
{
"mcpServers": {
"amicited": {
"type": "http",
"url": "https://api.flowhunt.io/mcp/amicited",
"headers": {
"Authorization": "Bearer <your-workspace-api-key>"
}
}
}
}
```
Os conectores MCP personalizados exigem o **Developer mode**, disponível nos planos pagos do ChatGPT (Plus, Pro, Team, Enterprise). Em workspaces Business, Enterprise e Edu, um administrador pode precisar ativá-lo para você.
1. Ative o Developer mode conforme descrito na [documentação de conectores da OpenAI](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt).
2. No ChatGPT, abra **Settings** e depois **Apps & Connectors**.
3. Adicione um conector personalizado e cole `https://api.flowhunt.io/mcp/amicited`.
4. Aprove o acesso na janela do navegador que abrir.
**Alternativa com chave de API.** Na etapa 4, escolha a autenticação por chave de API e cole a chave de API do seu workspace. Salve o conector e depois ative-o em um novo chat.
Na página **MCP** do app, selecione **Cursor** e clique em **Add to Cursor**. O Cursor instala o servidor e faz o login para você.
Se o botão não abrir o Cursor, adicione o servidor manualmente nas configurações do Cursor, em MCP, ou edite `~/.cursor/mcp.json` (ou um `.cursor/mcp.json` por projeto):
```json {title="~/.cursor/mcp.json"}
{
"mcpServers": {
"amicited": {
"url": "https://api.flowhunt.io/mcp/amicited"
}
}
}
```
O Cursor abre um navegador para o login na primeira vez que se conecta. Defina o chat como modo **Agent** para usar as ferramentas.
**Alternativa com chave de API.** Adicione um cabeçalho à mesma entrada:
```json
"headers": { "Authorization": "Bearer <your-workspace-api-key>" }
```
O VS Code usa o servidor por meio do **GitHub Copilot no modo Agent**, então o Copilot precisa estar ativado.
Na página **MCP** do app, selecione **VS Code** e clique em **Add to VS Code**. O VS Code instala o servidor e faz o login para você.
Para adicioná-lo manualmente, abra a Command Palette, execute **MCP: Open User Configuration** e adicione o servidor em `servers`:
```json {title="mcp.json"}
{
"servers": {
"amicited": {
"type": "http",
"url": "https://api.flowhunt.io/mcp/amicited"
}
}
}
```
**Alternativa com chave de API.** Adicione `"headers": { "Authorization": "Bearer <your-workspace-api-key>" }` à entrada. Você também pode executar **MCP: Add Server...**, escolher **HTTP (HTTP or Server-Sent Events)**, colar a URL e adicionar o cabeçalho `Authorization` quando solicitado.
O Codex se conecta como um cliente MCP remoto padrão. Adicione o servidor e depois faça o login:
```bash
codex mcp add amicited --url https://api.flowhunt.io/mcp/amicited
codex mcp login amicited
```
Ou edite `~/.codex/config.toml` diretamente:
```toml {title="~/.codex/config.toml"}
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
oauth_resource = "https://api.flowhunt.io/mcp/amicited"
```
**Alternativa com chave de API.** Coloque a chave em uma variável de ambiente e aponte o Codex para ela:
```toml {title="~/.codex/config.toml"}
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
bearer_token_env_var = "AMICITED_API_KEY"
```
Um Codex executado com configurações de aprovação rígidas ainda alcança todas as ferramentas somente leitura por `read_tool`. Veja [toolsets e ferramentas](/docs/mcp/toolsets/).
## OAuth ou chave de API
| | OAuth 2.1 (recomendado) | Chave de API do workspace (alternativa) |
|---|---|---|
| **Configuração** | Cole a URL e aprove no navegador | Cole a URL mais um cabeçalho `Authorization: Bearer` |
| **Workspace** | Escolhido na tela de consentimento | Fixado pela chave |
| **Permissões** | `amicited:read` para conectar e ler; `amicited:write` também é necessário para escrita | Acesso total ao workspace |
| **Revogação** | **Connected clients → Revoke** na página MCP | Exclua ou faça a chave expirar |
O OAuth é o melhor padrão: não há segredo para colar em um arquivo de configuração, cada cliente aparece pelo nome na página **MCP**, em **Connected clients**, e você pode revogar um sem tocar nos outros. Um token OAuth somente leitura pode listar e ler tudo, mas qualquer ferramenta que cria, edita ou exclui recusará com uma mensagem que cita o escopo `amicited:write`. Tentar de novo não ajuda; reconecte com acesso de escrita.
Qualquer pessoa com uma chave de API do workspace pode executar todas as ferramentas do servidor sobre os dados do seu workspace, inclusive escrita. Prefira o OAuth, mantenha as chaves fora de repositórios compartilhados e use uma variável de ambiente quando seu cliente permitir.
## Verifique se funciona
Peça algo pequeno ao seu agente: *"List my AmICited domains."* Ele deve chamar `list_domains` e devolver seus domínios pelo nome. Depois tente *"Show my AI visibility for the last 30 days"*, que usa `prompt_analytics`.
Se a conexão for recusada, a mensagem geralmente diz o motivo:
- **Plano.** "requires a Pro plan or above": o plano do proprietário do workspace não inclui o MCP.
- **Créditos.** O saldo do workspace é zero ou negativo. Recarregue e tente de novo.
- **Limite de taxa.** As chamadas de ferramentas têm um limite por workspace por hora: 120 no teste, 600 no Pro, 2.000 no Premium, ilimitado no Enterprise. A mensagem diz quando a janela é reiniciada. Listar ferramentas e ler skills não contam.
## Relacionados
Como um agente encontra a ferramenta certa entre mais de 300 sem carregar todas.Prompts prontos para copiar e colar: briefings, quedas, lacunas e artigos.Os playbooks integrados que os agentes leem antes de perguntas de várias etapas.Quais planos incluem o MCP e o que cada um permite.
Source: https://www.amicited.com/pt/docs/mcp/connect/
Esc
↑↓ navegar↵ abrir
Consentimento de Cookies Usamos cookies para melhorar sua experiência de navegação e analisar nosso tráfego. Política de privacidade.
Configurações de Cookies
Cookies Necessários
Esses cookies são necessários para o funcionamento do site e não podem ser desativados.
Cookies de Análise
Esses cookies nos ajudam a entender como os visitantes interagem com nosso site.
Cookies de Marketing
Estes cookies são usados para medir a eficácia das nossas campanhas publicitárias e apoiar publicidade relevante em plataformas de terceiros.
Cookies Funcionais
Estes cookies são usados para lembrar as suas preferências e melhorar a sua experiência.