# Troubleshooting And FAQ

> Resolve connection, team, scope, tool-selection, data visibility, scheduling, privacy, and API-vs-MCP questions.

> Resolve common MCP connection, team, scope, tool-selection, data visibility, scheduling, privacy, and API-vs-MCP questions.

Use this page when an AI client cannot connect to Kommon Poll, does not call Kommon Poll tools, or returns data that does not match expectations.

---

## Connection And Authorization

| Question | Answer |
| --- | --- |
| Why can't I add Kommon Poll MCP? | Confirm your AI client supports MCP or connectors, your plan allows it, and your administrator has not disabled custom tools. |
| Why does authorization not open? | Check browser pop-up restrictions, client support, network access, and whether the MCP server details are correct. |
| Why did login succeed but the connector still shows disconnected? | Retry the connection, confirm the final consent step completed, and check whether the AI client requires a refresh or new conversation. |
| How do I revoke access? | Remove or disconnect Kommon Poll from the AI client's connector settings, and revoke access in Kommon Poll if that control is available. |
| Can I paste a token into the prompt? | No. Use the approved OAuth connection flow. |

---

## Teams And Saved Searches

| Question | Answer |
| --- | --- |
| Why can't the AI see all my Kommon Poll projects? | The connection is limited to the authorized user, selected team, granted scopes, and saved searches available to that context. |
| How do I switch teams? | Reconnect and select the correct team, or use the client-specific switching behavior if available. |
| Why is a saved search visible in Kommon Poll but not through MCP? | Confirm the saved search belongs to the selected team and that the signed-in user has permission to access it. |
| Can I connect multiple Kommon Poll accounts or teams? | This depends on the AI client. Some clients may require separate connections or reconnecting for each team. |

---

## Tool Use

| Question | Answer |
| --- | --- |
| Why does the AI not call Kommon Poll? | Ask explicitly to use Kommon Poll, provide the saved-search name, and confirm tools are enabled for the conversation or agent. |
| How do I force a safe first test? | Ask: "What Kommon Poll saved searches can you access?" |
| Can the AI modify Kommon Poll data? | The MCP docs should mark every tool as read-only or write-capable. If only read tools are available, the AI cannot modify Kommon Poll data through MCP. |
| What if the AI chooses the wrong saved search? | Ask it to list available saved searches and confirm the one it should use before analysis. |

---

## Data And Metrics

| Question | Answer |
| --- | --- |
| Why are there fewer mentions than expected? | Check date range, timezone, filters, pagination, saved-search scope, and platform availability. |
| How do date ranges and timezones work? | Use a clear reporting period and timezone in every prompt. The tool should apply supported date controls and state them in the output. |
| Why are some fields missing? | Not every platform provides every metric or metadata field. Missing values should not automatically be treated as zero. |
| Can mention examples represent the full dataset? | Only if the workflow retrieves and analyzes the full relevant set. Otherwise, mention pages are examples or samples. |

---

## Platform Modes

| Question | Answer |
| --- | --- |
| Does Kommon Poll MCP work in Deep Research, Research, agent mode, or scheduled tasks? | It depends on the AI client and mode. Verify tool availability for each mode before relying on it. |
| What should I use if my AI client does not support MCP? | Use the Kommon Poll application for interactive analysis or the Kommon Poll API for programmatic integrations. |
| When should I use the API instead? | Use the API for deterministic backend services, dashboards, ETL, scheduled jobs, and production pipelines. |
| What data does the AI provider receive? | The AI provider receives the Kommon Poll data returned by the MCP tools invoked in that client. Review the provider's data retention and privacy settings. |

---

## Error Checklist

When troubleshooting, collect:

- AI client name and mode.
- Kommon Poll team selected during authorization.
- Saved-search name.
- Prompt used.
- Error message.
- Whether tools are enabled.
- Whether the same user can access the saved search in Kommon Poll.
- Whether the issue affects listing searches, overview analytics, or mentions.